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APPENDIX A 
RSX-11M SUPPORTED DEVICES 



A.l RSX-11M DEVICE SUPPORT 

RSX-11M is a disk based real-time operating system that runs on any 

UNIBUS PDP-11 processor. During system generation, the user can 

configure RSX-11M for systems ranging in size from 16K- to 
1920K-words. 



The user can generate RSX-11M as either a mapped or unmapped system. 
A mapped system must include the KT11 Memory Management Unit. Without 
the KT11 Memory Management Unit, RSX-llM supports between 16K- and 
28K-words of memory. With the KTll, RSX-llM supports between 24K- and 
124K-words of memory on processors other than the PDP-11/70. RSX-llM 
provides the same primary services for both mapped and unmapped 
systems? however, some supplied optional features and separately 
orderable options require hardware configurations larger than the 
minimum supported system. 

For complete and detailed information about minimum hardware required 
for the different kinds of RSX-llM distribution kits, various options, 
and combinations of peripherals, see the DIGITAL Software Product 
Description for RSX11-M, Version 3.1, Real Time Operating System and 
the RSX-l lM System Generation Manual . The RSX-llM Operator's 
ProcedUrei Manual contains a table ot RSX-llM peripheral, pseudo, and 
null devices along with their respective identifiers (device-unit 
names recognized by RSX-llM) . 

RSX-llM supports the following: 



A. 1.1 Processors And Options 

• Any PDP-11 processor except the LSI-11 and PDP-11/03 

- A minimum of 16K-words of memory (unmapped system) 

- Between 24K and 124K-words of memory on a system other than 
the PDP-11/70 (mapped system with the KTll Memory Management 
Unit); and between 64K and 1920K-words on the PDP-11/70. 

- KTll Memory Management Unit (requires a minimum of 24K-words 
of memory) 

- KE11-A,B Extended Arithmetic Element (on systems without a 
memory management unit) 

- KEll-E Extended Instruction Set 

- KEll-F Floating Instruction Set 
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- FPU Floating Point Processor 

- KW11-Y Watch-dog Timer Clock 

A. 1.2 Card Readers 

• CRll card reader 

• CMll card reader 

A. 1.3 Communications 

• DL11-E single line interface 

• DP11 synchronous line interface 

• DU11 synchronous line interface 

• DUPll synchronous line interface 

• DQ11 DMA synchronous line interface 

• DAll-B DMA UNIBUS link 

• DMC11 interprocessor link 

A. 1.4 Data Acquisition 

One or more of the following subsystems: 

• LPS11 Laboratory Peripheral System (requires LPS11-S, 
LPSAD-12, and LPSKW) 

• AR11 Analog Real-time System 

• LPA11-K Laboratory Peripheral Accelerator 

• Laboratory I/O Subsystem configured using the following 
options: 

1. ADKll-KT 12-bit A/D converter with 16-channel multiplexer 
and dual clock; one per subsystem) 

2. ADll-K 12-bit A/D converter with 16-channel multiplexer; 
16 per subsystem (15 if ADKll-KT is part of same 
subsystem) 

3.' KWll-K Dual real-time clock with Schmitt triggers; 1 per 
subsystem (clock already included in ADKll-KT, not KWll-K 
required if one is present) 

4. AMll-K 48-channel A/D multiplexer with gain ranging; one 
per ADll-K or ADKll-KT 

5. DRll-K 16-bit digital I/O option; 16 per subsystem 

6. AAll-K 4-channel 12-bit D/A converter with scope control, 
16 per subsystem 
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A. 1.5 Disk Devices 

• RXll floppy disk system 

• RF11 fixed-head disk system 

• RKll disk cartridge controller with RK05J or RK05F disk drives 

• RK611 disk cartridge controller with RK06 or RK07 disk drives 

• RPR02 disk pack drives (with appropriate controller) 

• RP03 disk pack drives (with appropriate controller) 

• RP04, RP05, or RP06 disk pack drives (with appropriate 
controller) 

• RS03 or RS04 fixed-head disks (with appropriate controller) 

• RM03 drives (with appropriate controller) 

• RLll disk cartridge controller with RL01 disk drives 

• RM02 drives (with appropriate controller) 



A. 1.6 Laboratory/industrial Control 

AD01-D A/D converter 

AFC11 A/D converter 

DRS/DSSll industrial control system modules 
UDC11 Universal Digital Controller 
IDAll-AA Contact sense module 
IDAll-AB Contact sense module 
IDAll-BA Contact interrupt module 
IDAll-BB Contact interrupt module 
IDAll-CA I/O converter 
IDAll-DA Solid state AC/DC driver 
IDAll-EA Flip-flop DC driver 
IDAll-FA Single shot driver 
IDAll-GA Latching output relay 
IDA11-HA Flip-flop output relay 
IDAll-JA Single shot output relay 
IAAll-AA Multi-range A/D converter 
IAAll-BA D/A converter 
IAAll-BB D/A converter 
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• IAAll-BC D/A converter 

• IAAll-BD D/A converter 

• ICS11/ICR11 Industrial Control subsystem 

• IDC-IA Isolated DC sense 

• IDC-IB Isolated DC interrupt 

• IDC-IC I/O counter 

• IDC-ID Non-isolated DC sense 

• IDC-IE Non-isolated DC interrupt 

• IAC-IA Isolated AC sense 

• IAC-IB Isolated AC interrupt 

• IDC-OA DC flip-flop driver 

• IDC-OB DC single shot driver 

• IAC-OA AC flip-flop driver 

• IAC-OB AC single shot driver 

• IRL-OA Latching output relay 

• IRL-OB Flip-flop output relay 

• IDA-OB 4-channel D/A converter 

• IAD-IA 8-channel A/D converter 

• IMX-IA 16-channel multiplexer for IAD-IA 

A. 1.7 Printers 

• LA35 line printer 

• LA180 line printer 

• LS11 line printer 

• LP11 line printer 

• LV11 line printer (no plotter support) 

A. 1.8 Tape Devices, Magnetic 

• TAll Dual drive cassette system 

• TC11 DECtape controller and dual transport 

• TS03 magnetic tape transport (with appropriate controller) 

• TU10 magnetic tape transport (with appropriate controller) 
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• TE10 magnetic tape transport (with appropriate controller) 

• TU16 magnetic tape transport (with appropriate controller) 

• TE16 magnetic tape transport (with appropriate controller) 

• TU45 magnetic tape transport (with appropriate controller) 



.1.9 Tape Devices, Paper 

• PCll paper tape reader/punch 

• PRll paper tape reader 



A. 1.10 Terminals 

• LA30 terminal 

• LA36 terminal 

• LA180S terminal on the following line devices only: 

- DH11 serial line terminal multiplexer (optional with DMll-BB 
modem control) 

- DZll serial line terminal multiplexer 

- DJ11 serial line terminal multiplexer 

- DL11-A,B,C,D,W single line terminal interface 

• LT33 terminal 

• LT35 terminal 

• VT05 terminal 

• VT50 terminal 

• VT52 terminal 

• VT55 terminal 
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APPENDIX B 
CODING STANDARDS AND CONVENTIONS 



B.l CODING STANDARD INTRODUCTION 

This Appendix contains DIGITAL'S PDP-11 Program Coding Standard. We 
suggest that you use this standard for you own installation when 
writing code, such as I/O drivers, for use with the PDP-11. 



B.l.l Line Format 

All source lines consist of from one to a maximum of eighty characters 
(not including the audit trail added by the SLIPR (SLP in RSX-llM) 
editor). This program is described in the RSX-llM utilities manual. 

Assembly language code lines have the following format: 

1. Label field - if present, the label starts at tab stop 
(column 1) . 

2. Operation field - the operation fiedl starts at tab stop 1 
(column 9) . 

3. Operand field - the operand field starts at tab stop 2 

(column 17) . 

4. Comments field - the comments field starts at tab stop 4 
(column 33) and may continue to column 80. 

Include comment lines in the code body by delimiting them with a line 
that contains only a semicolon. The comment lines contain a leading 
semicolon with the comment itself starting in column 3. 

If the operand field extends beyond tab stop 4 (column 33), leave a 

space and start the comment. Comments that apply to an instruction 

but require continuation should always line up with the character that 
started the comment. 




Delimit preface text, which describes formats, algorithms, 
program-local variables, etc., by the character sequence ;+ at the 
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start of the text and ;- at the end. These delimiters ease the 
extraction of the text by a program which could be designed for the 
purpose. The comments themselves start in column 3. 

For example: 

! + 

THE INVERT ROUTINE ACCEPTS 
A LIST OF RANDOM NUMBERS AND 
APPLIES THE KOLMOGOROV ALGORITHM 
TO THEM 



B.1.3 Naming Standards 



B. 1.3.1 Register Standards - 



B.1.3. 1.1 General Purpose Registers - The following names are the 

only ones permitted for register names and may not be used for other 
purposes: 

R0»0 ;REG 

Rl-1 ?REG 1 

R2=2 ;REG 2 

R3=3 fREG 3 

R4«4 'REG 4 

R5=5 ;REG 5 

SP=6 ; STACK POINTER (REG 6) 

PC=7 ; PROGRAM COUNTER (REG 7) 



B.1.3. 1.2 Hardware Registers - Name hardware registers identically to 
the hardware definition. For example, PS and SWR. 



B.1.3. 1.3 Device Registers - Device registers are symbolically and 
identically named to the hardware notation. For example, the control 
status register for the RK disk is RKCS. You may use only this 
symbolic name to refer to this register. 



B.1.3. 2 Processor Priority - Use the following bits to test or alter 
processor priority: 

PRO, PRl, PR2, PR7 

The system equates thes bits to their corresponding bit pattern. 



B.1.3. 3 Other Symbols - Make frequently-used bit patterns, such as CR 
and LF, conventional symbols on an as-needed basis. 
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B.l.3.4 Using the Standard Symbols - Register standards are defined 
within the assembler. All other standard symbols appear in a file and 
are linked prior to program execution. 



B.1.4 Symbols 



B. 1.4.1 Global Symbols - You can easily recognize global symbols by 
their format. The following standards apply and completely define 
symbol standards for PDP-11 Medium/Large software products. 

Figure B-l describes the difference among global and local symbols. 





Character Positions 






Symbol 


1 


2 


3 


4 


5 


6 


Length 


Non global 
symbol 


L, AN 


AN or 
null 


AN or 
null 


AN or 
null 


AN or 
null 


AN or 
null 


>-l 


Global 
symbol 


$ or . 


AN or 
null 


AN or 
null 


AN or 
null 


AN or 
null 


AN or 
null 


>-l 


Global 
offset 


L 


$ or . 


AN 


AN or 
null 


AN or 
null 


AN or 
null 


>-3 


Global bit 
pattern 


L 


AN 


$ or . 


AN 


AN or 
null 


AN or 
null 


>=4 


Local 
symbol 


N 


$ 










>-2 



where: 

L 

AN 

null 

5 

N 
* 



is a letter 

is an alphanumeric character 

is no character 

is a dollar sign (reserved for DEC-supplied software) 

is a period (reserved for DEC-supplied software) 

is a number in the range of through 65535 

means that branch targets in the form of x$ , where x is a 
number, are also called labels. 

Figure B-l Difference Among Global and Local Symbols 
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B.l.4.2 Symbol Examples - Non-global Symbols 

AlB 

ZXCJ1 

INSRT 
Global Address Symbols 

$JIM 

.VECTR 

$SEC 
Global Absolute Offset Symbols 

A$JIM 

A$XT 

A-ENT 
Global Bit Pattern Symbols 

Al$20 

B3.6 

JI.M 
Local Symbols 

37$ 

271$ 

6$ 



B.l.4.3 Program-Local Symbols - Self-relative address arithmetic 
(,+n) is absolutely forbidden in branch instructions. It must not be 
used in other contexts if at all possible. 

Target labels (symbols) for branches that exist only for positional 
reference use local symbols of the form: 

<num>$ : 

Restrict use of global symbols to cases where reference to the symbol 
occurs external to the code. The assembler formats local symbols to 
proceed sequentially down the page and from page to page. 



B.l.4.4 Macro Names - The last two characters in a macro name have 
special significance. The next to last character is a $ and the last 
character specifies the mode of the macro. (The last character may 
also be a null character.) 
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For example, three macro forms exist: in-line, stack, and p-section. 
The in-line form has no suffix (the $ is last) . The stack has an S as 
the last character. The p-section has a C as the last character. 
Thus, the QUEUE I/O macro can be written in any one of the three 
following ways: 

QIO$ 

QIO$S 

QIO$C 

The letters S and C are not reserved but the form of the macro is 
standard. 



B.1.5 Program Modules 



B.l.5.1 General Comments on Programs - In DEC software, a program 
provides a single distinct function. No limits exist on size, but the 
single function limitation makes large modules a rarity. Because any 
software may exploit the memory capacity of the 11/40, 11/45, or 
11/70, programs should maintain a dense reference locus (branching 
should occur over short address distances) . 

All code is read only. Code and data areas are distinct and each 
contains explanatory text. Read-only data should be segregated from 
read-write data. 



B.1.5. 2 Module Preface - Each program module in the system exists as 
a separate file. The filename reflects the name of the module and the 
extension is of the form 'NNN'. NNN signifies the edit number or the 
version number. The version number is changed only when a new base 
level is created. Furthermore, if no corrections are made to a file 
from one base level to the next, the version number is not changed. 
The availability if File Control Services and File Control Primitives 
greatly simplify version number maintenance. Program modules adhere 
to a strict format. Reading and understanding the code is easier 
because of this format. The following sections are in each module: 

For the code section: 

1. A .TITLE statement that specifies the name of the module. If 
a module contains more than one routine, you may use 
subtitles. 

2. A .IDENT statement that specifies the version number. The 
PDP-11 version number standard appears in section B.10. 

3. A .PSECT statement that defines the program section in which 
the module resides. 

4. A copyright statement and the disclaimer. 

5. The version number of the file. 

The PDP-11 version number standard is described in section 
B.10. 
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6. The name of the principal author and the date on which the 
module was first created. 

7. The name of each modifying author and the date of the 
modification. Names and modification dates appear one per 
line and in cronological order. 

8. A brief statement of the function of the module. 
Notes Items 1-8 should appear on the same page. 

9. A list of the definitions of all equated local symbols used 
in the module. These definitions appear one per line and in 
alphabetical order. 

10. All local macro definitions, preferably in alphabetical order 
by name. 

11. All local data. The data should indicate: 

a. Description of each element (type, size, etc.) 

b. Organization (functional, alpha, adjacent, etc.) 

c. Adjacency requirements. 

12. A more detailed definition of the function of the module. 

13. A list of the inputs expected by the module. This includes 
the calling sequence if non-standard, condition code 
settings, and global data settings. 

14. A list of the outputs produced as 'a result of entering this 
module. These include delivered results, condition code 
settings, but not side effects. (All these outputs are 
visible to the caller.) 

15. A list of all effects (including side effects) produced as a 
result of entering this module. Effects include alterations 
in the state of the system not explicitly expected in the 
calling sequence, or those not visible to the caller. 

16. The module code. 



B.l.5.3 Formatting the Module Preface - Rules: 

1. The first eight items appear on the same page and should not 
have explicit headings. Item 3 may be omitted if the blank 
P-section is being used, 

2. Headings start at the left margin. The left margin consists 
of a semi-colon followed by a space. Therefore, the heading 
starts in column 3. Indent descriptive text one tab 
position. 

3. Items 7-14 have headings that start at the left margin and 
are preceded and followed by lines that contain only a 
leading semi-colon. Omit items that do not apply. 
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An example of a module preface follows: 

FILE-EXAMPL.SG1 
.TITLE EXAMPLE 
.IDENT /01/ 
.PSECT KERNEL 

COPYRIGHT (C) 1978 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOPTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 

VERSION 01 

JOHN HANCOCK l-JAN-75 

MODIFIED BY: 

QUINCY ADAMS 21-JAN-76 

JAMES MONROE 12-JUN-76 

Brief statement of the module's function. 

EQUATED SYMBOLS 

List equated symbols. 

LOCAL MACROS 

Local macros 

LOCAL DATA 

Local data 
+ 
Module function details 

INPUTS: 

Description of inputs 

OUTPUTS : 

Description of outputs 

EFFECTS: 

Descriptions of effects 

Begin module code 
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B.l.5.4 Modularity - No other characteristic has more impact on the 
ultimate engineering success of a system than does modularity. 
Modularity for PDP-11 Software Engineering's products consists of the 
application of the single-function philosophy described in section 
B.5.1 and the adherence to a set of calling and return conventions. 



B.l.5.5 Inter-Module Calling Conventions - The following calling 
conventions must be observed: 

Transfer of Control 

Macros exist for call and return. The actual transfer is by a 
JSR PC instruction. For register save routines, a JSR Rn,SAVE 
instruction is permitted. 

The CALL macro is.i 

CALL subroutine-name 
The RETURN macro is: 

RETURN 

Register Conventions 

Upon entry, a subroutine minimally saves all registers it intends 
to alter except result registers. Upon exit it restores these 
registers. (State preservation is assumed across calls.) 

Argument Passing 

Any registers may be used to pass arguments, but their use should 
follow a coherent pattern. For example, if passing three 
arguments, pass them in RO , Rl , and R2 rather than RO , R2 , and 
R5 . Saving and restoring occurs in one place. 



B.l.5.6 Exiting - All subroutine exits occur through a single RETURN 
macro. 

B.l.5.7 Intra-Module Calling Conventions - These calling conventions 
are designer optional, but consistency favors a calling sequence 
identical to that of the inter-module sequence. 



B.l.5.8 Success or Failure Indication - The C-bit indicates success 
or failure where success equals and failure equals 1. You can use 
the argument registers to return values or additional success or 
failure data. 



B.l.5.9 Module Checking Routines - Modules must verify the validity 
of arguments passed to them. The design of a module's calling 
sequence should aim at minimizing the validity checks by minimizing 
invalid combinations. You may add test code to perform additional 
checks during checkout. All code should aim at discovering an error 
as close (in terms of instruction executions) to its occurence as 
possible. 



B-8 



CODING STANDARDS AND CONVENTIONS 



B.1.6 Formatting Standards 



B. 1.6.1 Program Flow - Programs should be organized on the li stin 9 
such that they flow down the page, even at the cost of an extra branch 
or jump. For example: 



BBB 




AAA 



COMMON 



shall appear on the listing asj 



TST 
BNE 


BBB 


AAA: 


• • • • 


w • * • 

BR 
BBB: 


• • * • 

CMN 

• « • • 


* • • a 

CMN: 


• • • • 

• • • • 


• • • • 


• • • * 


Rather 


than: 


TST 
BNE 
AAA: 


BBB 


• • • • 

CMN: 


• ■ • * 


• • » * 

BBB: 


• " * * 


• * • * 

BR 


• • • * 

CMN 
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B.l.6.2 Common Exits - A common exit appears as the last code 
sequence on the listing, illustrated by the following flow chart: 





PR1 






PR2 






PR3 




PR4 








EXIT 




should 


appear on 


the listing as: 


PR1: 


• • • • 


• • • • 


• • # • 

BR 
PR2: 


EXIT 




• • • a 

BR 
PR3: 


EXIT 

• • • • 




« • * • 

BR 
PR4: 


EXIT 

• • • • 




• « • • 

EXIT: 


• • • • 


.... 


and not 


as: 




PR1: 


• • • • 


• • ■ • 


• • • • 

EXIT: 


• • • • 




• • • • 

PR2: 


• • • • 


.... 


br" 

PR3: 


EXIT 




• • • • 

BR 
PR4: 


EXIT 




BR 


• 




EXIT 
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B.l.6.3 Code with Interrupts Inhibited - Code 
instructions with interruptions inhibited, should 
comment delimiter of three semicolons. For example: 



that executes 
be flagged by a 



. .ERTZ; 

BIS 
BIT 
BEQ 
RTT 

10$: 



PR7,PS 
PR7,+2(SP) 
10$ 



ENABLE BY RETURNING 
BY SYSTEM SUBROUTINES 
INHIBIT INTERRUPTS 
C 

M 
M 
E 
N 
T 
S 



B.1.7 Program Source Files 

Creation of and maintenance of source code is done in base levels. A 
base level is defined as a point at which changing the program source 
files is no longer allowed. From this "frozen" point to the next base 
level, corrections are not made to the base level itself; rather, a 
file of corrections is accumulated for each file in the base level. 
Whenever a updated source file is desired, the correction file is 
applied to the base file. 

The accumulation of corrections proceeds until a logical breaking 
point has occurred (for example, a milestone or significant 
implementation point is reached). At this time, all accumulated 
corrections are applied to the previous base level to create a new 
base level. Correction files are then started for the new base level. 



B.1.8 Forbidden Instruction Usage 

The following instruction usage is not allowed: 

1. The use of intructions or index words as literals of the 
previous instruction. For example, the sequence: 



MOV 



BIC 



@PC, REGISTER 
SRCDST 



uses the bit clear instruction as a literal. This may seem 
to be a very good way to save a word but this compounds the 
problem of program maintenance. To make matters worse, this 
sequence does not execute correctly if I/D space is enabled 
on the PDP-11/45. In this case, @PC is a D bank reference. 

The use of the MOV instruction instead of a JMP instruction 
to transfer program control to another location. For 
example: 



MOV 



ALPHA, PC 



transfers control to location ALPHA. Besides taking longer 
to execute (2.3 microseconds for the MOV vs. 1.2 for the 
JMP) the use of MOV instead of JMP makes it nearly impossible 
to pick up someone else's program and tell where transfers of 
control take place. A jump trace of a program's execution is 
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impossible in this case (a move trace is unheard of) . As a 
more general issue, other operations such as ADD and SUB from 
the PC should be discouraged. Possibly one or two words can 
be saved by using these operations, but occurences where 
these operations can be used are rare. 

3. The seemingly clever use of all single word instructions 
where one double-word instruction could be used, would 
execute faster, and would not consume additional memory. 
Consider the following instruction sequence: 

CMP -(R1),(-R1) 

CMP -CR1),-(R1) 

The intent of this instruction sequence is to subtract 8 from 
register Rl (not to set condition codes) . This can be 
accomplished in approximately 1/3 the time by using a SUB 
instruction (9.4 vs. 3.8 microseconds) at no additional cost 
in memory space. Also, if Rl is odd this instruction does 
not give the correct result. The SUB instruction is always 
faster and always executes correctly. 



B.1.9 Recommended Coding Practice 



B. 1.9.1 Conditional Branches - When using the PDP-11 conditional 
branch instructions, the correct choice must be made between the 
signed and the unsigned branches. 

Signed Unsigned 

BGE BHIS (BCC) 

BLT BLO 

BGT BHI 

BLE BLOS (BCS) 

A common pitfall is to use a signed branch (for example, BGT) when 
comparing two memory addresses. This compare works until the two 
addresses have opposite signs? that is, one of them goes across the 
16K (100000(8)) boundary. This type of coding error usually occurs 
when a program is re-linked at different addresses or the program's 
size is changed. 



B.1.10 PDP-11 Version Number Standard 

The PDP-11 Version Number Standard applies to all modules, parameter 
files, complete programs, and libraries that are written as part of 
the PDP-11 Software Development effort. It provides unique 
identification of all released, pre-released, and in-house software. 

It is limited because, as currently specified, only six characters of 
identification are used. Future implementations of the Macro 
Assembler, Task Builder, and Librarian should provide for at least 
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nine characters, and possibly twelve. This standard will change as 
the need arises. The version identifier takes the following form: 

Version Identifier * <form> <version> <edit> <patch> 

<form> Identifies a particular form of a module or 
program, where applicable, as in the case of 
LINK-11. One alphabetic character, if used, and 
null (for example, a binary 0) if not used. 

<version> Identifies the release or generation of a program. 
The version number is two decimal digits that 
start at 00 and is incremented at the discretion 
of the project to reflect a major change. 

<edit> Identifies the level to which a particular release 
or generation of a program or module has been 
edited. An edit is an alteration to the source 
form. The edit number consists of two decimal 
digits that begin at 01. The number is 
incremented with each edit and remains null if no 
edit occurs. 

<patch> Identifies the level to which a particular release 
or generation of a program or module has been 
patched. A patch is an alteration to a binary 
form. The patch identification consists of one 
alphabetic character that starts at B. The 
character is changed toward Z each time a set of 
patches is released and remains null if no patches 
are made. 

These fields are interrelated. When version is changed, patch and 
edit must be reset to nulls. When edit is incremented, patch is 
re-set to null because various bugs have been fixed. 



B. 1.10.1 Displaying the Version Identifier - The visible output of 
the version identifier should appear as: 

Key <letter> <form> <version> - <edit> <patch> 

where the following Key letters have been identified: 

V released or frozen version 

X in-house experimental version 

Y field test, pre-release, or in-house release version 

and 'V to company support. 

Use the dash that separates version from edit only if edit or patch is 
not null. When a version identifier is displayed as part of a program 
identification, the format is: 

Program 

<space>< key-let ter><form><version>-<edit>< pa tch> 

Name 



Examples: 



PIP X03 
LINK VB04-C 
MACRO Y05-01 
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B. 1.10. .2 Dse of the Version Number in the Program - All sources must 
contain the version number in an .IDENT directive. For programs (or 
libraries) that consist of more than one module, each individual 
module follows this version number standard. The version number of 
the program or library is not necessarily related to the version 
numbers of the consituent modules; it is perfectly reasonable, for 
example, that the first version of a new FORTRAN library, V00, contain 
an existing SIN routine, say V05-01. 

Parameter files are also required to contain the version number in an 
•IDENT directive. Because the assembler records the last .IDENT seen, 
parameter files must precede the program. 

Entities that consist of a collection of modules or programs (for 
example, the FORTRAN library) have an identification module in the 
first position. An identification module exists solely to provide 
identification and normally consists of something like: 

;OTS IDENTIFICATION 
.TITLE FTNLIB 
.IDENT /003010/ 
.END 



B.l.ll Co-routines 

In some cases, two program routines are highly interactive. They then 
use a special case of the JSR instruction ( JSR PC,@(SP)+ ). This 
form of the JSR instruction exchanges the top element of the stack and 
the contents of the program counter (PC) . In this way, two routines 
may swap program control and resume operation where they stopped, when 
recalled. Such routines are called co-routines. 



This swapping of control is illustrated below with an actual 
of instructions from RSX-11M Executive code (Version 3.1). 



sequence 



CODE 
$DRECP: 



CALLR $NXTSK 
(1) (JMP $NXTSK) 



ACTION 

Address of caller 
of $DRECP > 

(1) PC=Address of $NXTSK 



STACK 



CALLER ADR 



$NXTSK: : 
SAVNR 

(1) (JSR R5,$ SAVNR) 

(2) MOV P.MAIN(RO) ,R5 



(1) Push R5 contents onto 
stack (save R5) . 
Put address of next 
instruction (2) into R5 
(return address) . 
Put address of $ SAVNR 
into PC. 



STACK 



CALLER ADR 



R5 
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$SAVNR:: 




(1) MOV R4, (SP) 


(1) 


(2) MOV R5, (SP) 


(2) 


(3) MOV 4(SP) ,R5 


(3) 


(4) CALL @<SP)+ 




(JSR PC,@(SP)+) 


(4) 


(5) MOV (SP)+,R4 




(6) MOV (SP)+,R5 




(7) RETURN 




(RTS PC) 





Save R4 on stack 
Save R5 on stack 
Restore saved R5 from 
the stack into R5 
Pop "call to" address 
(address of step (2) in 
$NXTSK) into PC. 
Push address of next 
instruction (5) onto 

StLcLGJC • 



STACK 



CALLER ADR 



R5 



R4 



(5) 



$NXTSK : : 
SAVNR 

(1) MOV P.MAIN(RO) ,R5 (1) Start $NXTSK processing 

here. 
(2) Pop address of (5) , in 
$ SAVNR, into PC. 

(2) RETURN 

(RTS PC) 



$ SAVNR: : 



(5) MOV (SP)+,R4 

(6) MOV (SP)+,R5 
{ 7 ) RETURN 

(RTS PC) 



(5) Pop saved R4 into R4. 

(6) Pop saved R5 into R5. 

(7) Return to caller of 

$DRECP . 



STACK 




CALLER 


ADR 


R5 


R4 


STACK 


CALLER 


ADR 
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MACRO EXPANSIONS 

C.l COMMAND STRING INTERPRETER MACRO EXPANSIONS 

C.l.l CSI$1 Macro 

This macro calls the command string syntax analyzer. 

.MACRO CSI$1 CSBLK,BUFF,LEM 

.GLOBL .CSI1 

.MCALL CSI$,LDR0$ 

.IF NDF C.SIZE 

CSI$ 

.ENDC 

LDR0$ CSBLK 

.IF NB <BUFF> 

MOV BUFF,C.CMLD+2(RG) 

• ENDC 

.IF NB <LEN> 

MOV LEN,C.CMLD(RO) 

.ENDC 

JSR PC,.CSI1 

.ENDM 

C.l. 2 CSI$2 Macro 

This macro calls the command string semantic parser. 

.MACRO CSI$2 CSBLK, 10, SWTAB 

.GLOBL .CSI2 

.MCALL CSI$,LDRO$ 

.IF NDF C.SIZE 

CSI$ 

.ENDC 

LDRO$ CSBLK 

.IF NB <I0> 

.IF IDN <INPUT>,<IO> 

MOVB #CS.INP, (RO) 

.IFF 

.IF IDN <OUTPUT>,<IO> 

MOVB #CS.OUT, (RO) 

.IFF 

.ERROR ; Incorrect request to .CSI2 

.ENDC 
.ENDC 
.ENDC 
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•IF NB <SWTAB> 

MOV SWTAB,C.SWAD(RO) 

.ENDC 

JSR PC.CSI2 

.ENDM 



C.1.3 CSI$SW Macro 

This macro defines the switch table entry. 



.MACRO CSI$SW SW,MK,MKW, 

.IF B,SW 

.ERROR 

.IFF 

.EVEN 

.NCHR SIZ$$,SW 

.IF GT,SIZ$$-2 

•IF B,LNG 

SIZ$$=2 

.ENDC 

.ENDC 

CNT$$=0 

.IRPC CHR$$$,SW 

CHR$$=' "CHR$$$ 

CNT$$«CNT$$+1 

.IF GE,<CHR$$-<'A+~O40>> 

•IF LE,<CHR$$-<'Z+"O40>> 

CHR$$=CHR$$-~O40 

• ENDC 
.ENDC 

.IF LE,CNT$$-SIZ$$ 
$.=0 

.IF NB,LNG 

.IF IDN,<LNG>,<EXACT> 
.IF GT,CNT$$&1 
.IF GE,CNT$$+1-SIZ$$ 
$$»"O200 

• ENDC 
.IFF 

.IF LT,CNT$$-SIZ$$ 
$?=*O200 

.ENDC 

. ENDC 

.IFF 

.IF IDN,<LNG>,<LONG> 

.IF EQ,CNT$$&1 

•IF LT,CNT$$-SIZ$$ 

$$="020 



CLR,NEGS,VALTAB,LNG 

; Missing switch name 

; Force to word alignment 
;Set SIZ$$ to no. of chars in sw 
;If string is longer than 2 chars 
; and not "long" or "exact" 
;trim it back to 2 characters 



;For each character in SW 



.ENDC 
.ENDC 
.IFF 
.ERROR 

• ENDC 
.ENDC 
.ENDC 

.BYTE CHR$$i$$ 
.ENDC 

• ENDM 
.EVEN 



; If .GE. lower case A 
; and .LE. lower case Z 
; convert to upper case alpha 

?If more characters to store 

If "long" or "exact" 

If "exact" 
and if first byte of word 
and if last word in switch name 
then set the exact match flag 

If 2nd byte of word 
and if not the last character 
set the "more ASCII words 
coming" bit 

;End of "if first byte of word" 

;If not '"exact" 

;Must be "long", otherwise error 

;If 2nd byte of word 

; and not the last character 

; set the "more ASCII words 

; coming" bit 



If not "long" 

Illegal "long" or "exact" 

specifier 
End of if "long" 
End of if "exact" 
End of IF NB,LNG 
Generate a character 
End of "if more characters" 
End of the IRPC loop 
Round up to next word boundary 
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.ENDC ;End of .IF B,SW 

.IF NB MK 
.WORD MK 

• IFF 
.WORD 

• ENDC 

.IF NB CLR 

.IF IDN <CLEAR>,<CLR> 

.IFF 

.IF IDN <SET>,<CLR> 

.IFF 

.ERROR ; Invalid set/clear spec 

.ENDC 

• ENDC 
.ENDC 

.WORD MKW+$$ 

.IF NB NEGS 

.IF IDN <NEG>,<NEGS> 

• IFF 

•ERROR ; Invalid negate spec 

. ENDC 

.ENDC 

.WORD VALTAB+$$ 

.ENDM 



C.1.4 CSI$ND Macro 

This macro defines the end of the switch value table end. 

.MACRO CSI$ND 
.WORD 
.ENDM 

C.1.5 CSI5SV Macro 

This macro defines the switch value table entry. 



$$«0 
$$-1 



VALTAB; 



•MACRO CSI$SV TYPE ,ADDR,LEN, VALTAB 
•IF NB VALTAB 

• ENDC 

•IF NB TYPE 

•IF IDN <ASCII>,<TYPE> 

•BYTE 1 

• IFF 

• IF IDN <NUMERIO,<TYPE> 
•BYTE 2 

.IFF 

•IF IDN <OCTAL>,<TYPE> 

.BYTE 2 

• IFF 

.IF IDN <DECIMAL>,<TYPE> 
.BYTE 3 

• IFF 

.ERROR ; Invalid conversion type 

.ENDC 
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.ENDC 
.ENDC 
.ENDC 
.IFF 
.BYTE 1 

• ENDC 

.IF NB LEN 
.BYTE LEN 
.IFF 
•ERROR 
.BYTE 

• ENDC 

.IF NB ADDR 
.WORD ADDR 

• IFF 

. ERROR 
.WORD 

• ENDC 
.ENDM 



;ASCII conversion assumed 



; Length missing 



;Value address missing 



C.1.6 LDR0$ Macro 

This macro conditionally loads RO , 

.MACRO LDR0$ ARG 
.IIF B,ARG,.MEXIT 
.NTYPE PAR$$$,ARG 
.IIF EQ,PAR$$$,.MEXIT 
MOV ARG,R0 
.ENDM 



C.1.7 CSI$ Macro 

This macro defines command string interpreter symbols. 

.MACRO CSI$ GBL 

.IF IDN <GBL>,<DEF$G> 

.GLOBL C . TYPR ,C . STAT ,C . CMLD , C . DEVD ,C . DIRD ,C . FILD ,C . SWAD 

.GLOBL C.MKW1,C.MKW2 

.GLOBL C .SIZE ,C .DSDS ,CS . INP ,CS .OUT 

.GLOBL CS.NMF,CS.DIF,CS.DVF,CS.WLD,CS.MOR,CS.EQU 

.ENDC 



C.TYPR=0 
C.STAT=1 
C.CMLD=2 

C.DEVD=6 



C.DIRD="0<12> 
C.FILD=~0<16> 



C.SWAD="0<22> 
C.MKW1="0<24> 



Request type (for CSI2) 

Status (from CSI2) 

Length of command string buffer 

Address of command string buffer 

Length of device name string 

Address of most recent device 

name string 
Length of most recent DIR info 
Address of DIR info 
Length appropriate to C.FILD+2 
CSIl - address of string seg 

where error occurred 
CSI2 - address of file name for 

current request 
Address of current switch table 
OR of masks for all switches 

found this call 
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C.MKW2="0<26> 

C.SIZE="0<54> 

C.DSDS=C.DEVD 

;C.TYPR VALUES 

CS.INP-1 

CS.OUT-2 

; C.STAT VALUES 

CS.NMF=1 

CS.DIF=2 

CS.DVF=4 

CS.WLD="O<10> 
CS.MOR=~O<20> 
CS.EQU-~O<40> 



On/off settings of masks for 

switches found 
Size of CSI control block (in 

bytes) 
Displacement to 6 word block for 

FCS 

Request input string 
Request output string 

1 ■ File name specified this seg 

of string 
1 - Dir info specified this seg 

of string 
1 ■ Device name specified this 

seg of string 
File name has wild card switch 
More string segs follow 
Equal sign seen by CSI1 



C.2 DIRECTIVE MACRO EXPANSIONS 

.MACRO CALL ADR 
JSR PC, ADR 
.ENDM CALL 
•MACRO RETURN 
RTS PC 
•ENDM RETURN 

.MACRO CALLR ADR 
JMP ADR 
.ENDM CALLR 



C.2.1 ABRT$C Macro 

ABRT$C generates a DPB for the ABORT TASK directive in 
PSECT followed by an EMT 377 in the user specified PSECT. 



a separate 



Macro call: ABRT$C TSK,PSCT,ERR 

Description: ABRT$C generates a DPB for the ABORT TASK directive in 
the separate $DPB$$ program section and generates an EMT 377 in the 
program section specified by PSCT. TSK, the task name, is the only 
argument required for the DPB definition. The optional argument, ERR, 
must be a valid assembler destination operand specifying an error 
routine address. Because this routine invokes ABRT$ , the same factors 
govern the expansion of code and symbolic offsets. 

.MACRO ABRT$C TSK, PSCT, ERR 
.MCALL ABRT$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

• IFTF 
ABRT$ TSK 

• IFT 

.PSECT PSCT 
DIR$ #$$$,ERR 
.ENDC 
.ENDM ABRT$C 



$$$= 
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C.2.2 ABRT$S Macro 

ABRT$S pushes a DPB for the ABORT TASK directive on the stack and 
generates an EMT 377. 

Macro call: ABRTSS NAMADR,ERR 

Description: ABRT$S pushes a DPB for the ABORT TASK directive on the 
stack. The argument, NAMADR, must be a valid assembler operand that 
yields the address of a double-word with the task name in RADIX-50. 
ABRT$S then generates an EMT 377 and considers the optional argument, 
ERR, the error routine address. 

.MACRO ABRT$S NADR,ERR 

.MCALL RFA$,DIR$ 

RFA$ NADR 

MOV (PC)+,-(SP) 

.BYTE 83., 3 

DIR$ ,ERR 

.ENDM ABRT$S 



C.2.3 ABRT$ Macro 

The ABRT$ macro generates a DPB for the ABORT TASK directive. 

Macro call: ABRT$ TSK 

Description: This macro creates a DPB for the ABORT TASK directive. 
The argument, TSK, is the name of the task to be aborted. 

This macro defines the following symbolic offset: 

A. BTTN- (length is 4 bytes) Task name. 

The ABRT$ macro generates the A. BTTN symbolic offset only when the 
$$$GLB is defined. The symbol, A. BTTN, is a global symbol in this 
case. 

•MACRO ABRT$ TSK 

•MCALL R50$,OFF$ 

.IF NDF $$$GLB 

•BYTE 83., 3 

R50$ TSK 

.ENDC 

•IF NDF A. BTTN 

.NLIST 

OFF? 

OFF$ A. BTTN, 4 

• LIST 

• ENDC 
•ENDM ABRT$ 



C.2.4 ALTP$C Macro 

The ALTP$C macro generates a DPB for the ALTER TASK PRIORITY directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 

Macro call: ALTP$C TTASK,NPRIO,PSCT,ERR 
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Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive in the programsection named $DPB$$. The DPB parameters are 
described in the ALTP$ macro. Then the macro generates an EMT 377 in 
the program section named in PSCT. The DIR$ macro describes the ERR 
error service address. The ALTP$ macro controls symbolic offset 
generation. 

•MACRO ALTP$C TTASK ,NPRIO, PSCT, ERR 

.MCALL ALTP$,DIR$ 

.IF NDF $$$GLB 

.PSECT $DPB$$ 

.IFTF 

ALTP$ TTASK, NPRIO 

.IFT 

.PSECT PSCT 

DIR$ #$$S,ERR 

• ENDC 

•ENDM ALTP$C 



C.2.5 ALTP$S Macro 

The ALTP$S macro generates the code to push a DPB for the ALTER TASK 
PRIORITY directive on the stack followed by EMT 377. 

Macro call: ALTP$S NAMADR, NPRIO, ERR 

Description: This macro generates the code to push a DPB for ALTER 
TASK PRIORITY on the stack. The argument, TNAMADR, must be a valid 
assembler source operand that yields the address of a double-word 
containing the RADIX-50 name specified in the ALTP$ macro. The macro 
then generates an EMT 377. The DIR$ macro describes the ERR error 
service address. 

.MACRO ALTP$S NAME, PRI, ERR 

•MCALL MOV$,RFA$,DIR$ 

MOV$ PRI 

RFA$ NAME 

MOV (PC)+,-(SP) 

.BYTE 9., 4 

DIR$ ,ERR 

.ENDM ALTP$S 



C.2.6 ALTP$ Macro 

The ALTP$ macro generates a DPB for the ALTER TASK PRIORITY directive. 

Macro call: ALTP$ TTASK, NPRIO 

Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive. The arguments are assumed to have the following meanings: 

TTASK»Name of target task for new priority 
NPRIO=New priority for task 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

A. LTTN- (length 4 bytes) target task name, 
T.LTPR- (length 2 bytes) new priority 
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If the macro is invoked with the $$$GLB symbol defined, the ALTP$ 
macro does not generate the DPB and ALTP$ defines the offsets as 
global symbols. 

.MACRO ALTP$ NAME,PRI 

.MCALL R50$,OFF$ 

.IF NDF $$$GLB 

.BYTE 9. ,4 

R50$ NAME 

•WORD PRI 

• ENDC 

.IF NDF A.LTTN 

•NLIST 

OFF? 

OFF$ A.LTTN, 4 

OFFS A.LTPR,2 

.LIST 

.ENDC 

.ENDM ALTP$ 



C.2.7 ALON$C Macro 

The ALUN$C macro generates a DPB for the ASSIGN LUN directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro Call: ALUN$C LUN, DEVNAM, DEVNUM, PSCT, ERR 

Description: This macro generates a DPB for the ASSIGN LUN directive 
in the program section named $DPB$$. The arguments through DEVNUM are 
the DPB parameters as described for the ALUN$ macro. The macro then 
generates an EMT 377 in the program section as specified by PSCT. The 
argument, ERR is as described for the DIR$ macro. For an explanation 
of symbolic offsets, see the ALUN$ macro. 

.MACRO ALUN$C LUN ,DA,DU ,CS ,ERR 
.MCALL ALUN$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$=. 



• IFTF 

ALUN$ LUN,DA,DU 

.IFT 

•PSECT CS 
DIR$ #$$$,ERR 

.ENDC 

.ENDM ALUN$C 



C.2.8 ALUN$S Macro 



The ALUN$S, macro generates the code to push a DPB for the ASSIGN LUN 
directive on the stack followed by an EMT 377. 

Macro call: ALUN$S LUN, DEVNAM, DEVNUM, ERR 

Description: This macro generates the code to push a DPB for the 
ASSIGN LUN directive on the stack. The arguments through DEVNUM must 
be valid assembler source operands, and they must specify the DPB 
parameters listed in the ALUN$ macro. The DIR$ macro describes the 
ERR argument. 
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.MACRO ALUN$S LUN,DA,DU ,ERR 

.MCALL MOV$,DIR$ 

MOV$ DU 

MOV$ DA 

MOVS LUN 

MOV (PC)+,-(SP) 

.BYTE 7,4 

DIR$ ,ERR 

.ENDM ALUN$S 



C.2.9 ALUN$ Macro 

The ALUN$ macro generates a DPB for the ASSIGN LUN directive. 

Macro call: ALUN$ LUN ,DEVNAM,DEVNUM 

Description: This macro creates a DPB for the ASSIGN LUN directive. 
The arguments are assumed to have the following meanings: 

LUN=Logical unit number, 

DEVNAM= Physical device name (two characters) , 

DEVNUM=Physical device unit number. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

A. LULU- (length 2 bytes) Logical unit number, 
A.LUNA- (2) Physical device name, 
A.LUNU-(2) Physical device unit number. 

If the macro is invoked with the symbol, $$$GLB, defined, ALUN$ does 
not generate the DPB and ALUN$ defines the offsets as global symbols. 

.MACRO ALUN$ LUN,DA,DU 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 7,4 

.WORD LUN 

•IF B <DA> 

.WORD 

.IFF 

.NCHR $$$T1,<DA> 
$$$T2=. 

.ASCII /DA/ 
.=$$$T2+2 

• ENDC 
.WORD DU 
.ENDC 

.IF NDF A. LULU 

.NLIST 

.IRP X,<,<A. LULU, 2>,<A. LUNA, 2>,<A.LUNU,2>> 

OFF$ X 

.ENDM 

.LIST 

• ENDC 
.ENDM ALUN$ 



C-9 



MACRO EXPANSIONS 

C.2.10 ASTX$C Macro 

The ASTX$C macro generates a DPB for the AST SERVICE EXIT directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 

Macro call: ASTX$C PSCT,ERR 

Description: This macro generates a DPB for the AST SERVICE EXIT 
directive in the program section named $DPB$$. The argument, PSCT, is 
the program section in which to generate an EMT 377. The DIR$ macro 
describes the ERR argument., 

• MACRO ASTX$C PSCT,, ERR 
.MCALL ASTX$,DIR$ 
•IF NDF $$$GLB 
•PSECT $DPB$$ 



$$$* 



.IFTF 
ASTX$ 

• IFT 

•PSECT PSCT 
DIR$ #$$$,ERR 

• ENDC 

.ENDM ASTX$C 



C.2.11 ASTXSS Macro 



The ASTX$S macro generates the code to push a DPB for the AST SERVICE 
EXIT directive on the stack followed by an EMT 377. 

Macro call: ASTX$S ERR 

Description: This macro generates the code to push a DPB for the AST 
SERVICE EXIT directive on the stack. Then a MONITOR TRAP is 
generated. The error routine address argument, ERR, results in an an 
unconditional call following the EMT because control should never be 
returned on the AST exit. 

ACRO ASTX$S ERR 
•MCALL DIR$ 
MOV (PC)+,-(SP) 
• BYTE 115., 1 
DIR$ 

.IIF NB <ERR>, JSR PC, ERR 
.ENDM ASTX$S 



C.2.12 ASTX$ Macro 

The ASTX$ macro generates a DPB for the AST SERVICE EXIT directive. 

Macro Call: ASTX$ 

Description: This macro creates a DPB for the AST SERVICE EXIT 
directive. It takes no arguments. 
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Note: If the symbol, $$$GLB, is defined, this macro does not generate 
any code. 

.MACRO ASTX$ 

•IF NDF $$$GLB 
.BYTE 115., 1 
.ENDC 
.ENDM ASTX$ 



C.2.13 CINT$C Macro 

The CINT$C macro generates a DPB in a separate PSECT for the CONNECT 
TO INTERRUPT VECTOR directive followed by an EMT 377 in the user 
specified PSECT. 

Macro calls CINT$C VEC, BASE, ISR, DSI ,PSW, AST, PSCT, ERR 

Description: CINT$C generates a DPB in the program section named 
$DPB$$ for the CONNECT TO INTERRUPT VECTOR directive. CINT$ describes 
the the DPB parameters. CINT$C then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. 

.MACRO CINT$C VEC , BASE , ISR, DSI , PSW, AST, PSCT , ERR 
.MCALL CINT$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$=. 



• IFTF 

CINT$ VEC, BASE, ISR, DSI, PSW, AST 

• IFT 

•PSECT PSCT 
DIR$ #$$$,ERR 
.ENDC 

•ENDM CINT$C 



C.2.14 CINT$S Macro 

The CINT$S macro generates the code to push a DPB on the stack for the 
CONNECT TO INTERRUPT VECTOR directive followed by an EMT 377. 

Macro call: CINT$S VEC , BASE, ISR, DSI , PSW, AST, ERR 

Description: CINT$S generates the code to push a DPB for the CONNECT 
TO INTERRUPT VECTOR directive on the stack. The DPB arguments must be 
valid assembler source operands and then must specify the information 
described in the CINT$ macro. The macro, RVP$ , pushes the arguments 
on the stack in reverse order. CINT$S also generates an EMT 377 and 
uses the ERR error service address as described in the DIR$ macro. 

•MACRO CINT$S VEC , BASE, ISR, DSI , PSW, AST, ERR 

.MCALL RVP$,DIR$ 

RVP$ VEC, BASE, ISR, DSI, PSW, AST 

MOV (PC)+,-(SP) 

.BYTE 129. ,7 

DIR$ ,ERR 

.ENDM CINT$S 
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C.2.15 CINT$ Macro 

CINT$ generates a DPB for the CONNECT TO INTERRUPT VECTOR directive. 

Macro call: CINT? VEC , BASE ,ISR,DSI ,PSW, AST 

Description: CINT$ generates a DPB for the CONNECT TO INTERRUPT 
VECTOR directive. The arguments are assumed to have the following 
meanings: 

VEC = Must be in the range 60(8) through the highest vector 
specified during SYSGEN, and must be a multiple of 4. 

BASE - Virtual base address for kernel APR 5 mapping of the ISR, 
and enable/disable interrupt routines — This address is 
automatically truncated to a 32 (10) -word boundary. The 
"base" argument is ignored in an unmapped system. 

ISR = Virtual address of the ISR, or to disconnect from the 
interrupt vector. 

DSI = Virtual address of the enable/disable interrupt routine. 
PSW = Initial priority at which the ISR is to execute — 
This is normally equal to the hard-wired interrupt 
priority, and is expressed in the form n*40, where n is a 
number in the range 0-7. This form puts the value in bits 
5-7 of pri. It is recommended that the programmer make 
use of the symbols PR4 , PR5 , PR6 , and PR7 for this 
purpose. These are implemented via the macro HWDDF$ found 
in [1,1]EXEMC.MLB. AST = Virtual address of an AST 
routine to be entered after the fork level routine queues 
an AST. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

C.INVE — Vector address (2) 

C.INBA — Base address (2) 

C.INIS — ISR address (2) 

C.INDI — Enable/disable interrupt routine address (2) 

C.INPS ~ Priority (2) 

C.INAS — AST address (2) 

If the macro is invoked with the $$$GLB symbol defined, the CINT$ 
macro does not generate the DPB and CINT$ defines the offsets as 
global symbols. 

.MACRO CINT$ VEC, BASE, ISR, DSI, PSW, AST 

.MCALL OFF$ 

.IP NDF $$$GLB 

.BYTE 129. ,7 

•WORD VEC 

.WORD BASE 

.WORD ISR 

.WORD DSI 

•WORD PSW 

•WORD AST 

.ENDC 

.IF NDF C.INVE 

OFF$ 

OFF$ C.INVE, 2 

OFF? C.INBA, 2 

OFF$ C.INIS, 2 
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OFF$ C.INDI,2 
OPF$ C.INPS,2 
OFF$ C.INAS,2 

• ENDC 

.ENDM CINT? 



C.2.16 CLEF$C Macro 



The CLEF$C macro generates a DPB for the CLEAR EVENT FLAG directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 

Macro call: CLEF5C EFN,PSCT,ERR 

Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive in the $DPB$$ program section. The CLEF$ macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The CLEF$ macro controls symbolic address 
generation. 

.MACRO CLEF$C EFN,CS,ERR 
.MCALL CLEFS, DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$= 



.IFTF 

CLEF$ EFN 

• IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM CLEF$C 



C.2.17 CLEF$S Macro 



The CLEF$S macro generates the code to push a DPB for the CLEAR EVENT 
FLAG directive on the stack followe by an EMT 377. 

Macro call: CLEF$S EFN, ERR 

Description: This macro generates the code to push a DPB for the 
CLEAR EVENT FLAG directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the CLEF$ macro. This macro also generates a monitor 
trap, using the error service address, ERR, as described in the DIR$ 
macro. 

.MACRO CLEF$S EFN, ERR 

.MCALL MOV$,DIR$ 

MOV$ EFN 

MOV (PC)+,-(SP) 

.BYTE 31. ,2 

DIR$ ,ERR 

•ENDM CLEF$S 
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C.2.18 CLEF$ Macro 

The CLEF? macro generates a DPB for the CLEAR EVENT FLAG directive. 

Macro call: CLEF? EFN 

Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive. The argument is assumed to have the following meaning: 

EFN=EVENT FLAG NUMBER. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

C.LEEF- (length 2 bytes) Event flag number. 

If the macro is invoked with the symbol, ???GLB, defined, CLEF? does 
not generate the DPB and CLEF? defines the offset as a global symbol. 

.MACRO CLEF? EFN 

.MCALL OFF? 

.IF NDF ???GLB 

.BYTE 31., 2 

•WORD EFN 

.ENDC 

.IF NDF C.LEEF 

.NLIST 

OFF? 

OFF? C.LEEF, 2 

.LIST 

• ENDC 

.ENDM CLEF? 



C.2.19 CMKT?C Macro 

The CMKT?C macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro Call: CMKT?C EFN,AST,PSCT,ERR 

Description: This macro generates a DPB for the CANCEL MARK-TIME 
REQUESTS directive in the ?DPB$? program section. The CMKT?S macro 
describes the DPB parameters. Then the macro generates an EMT 377 in 
the program section named in the PSCT argument. The DIR? macro 
describes the ERR error service address. 

.MACRO CMKT?C EFN , AST, PSCT, ERR 
.MCALL CMKT?,DIR? 
.IF NDF ???GLB 
.PSECT ?DPB?? 

.IFTF 

CMKT? EFN, AST 

• IFT 

.PSECT PSCT 

DIR? #???,ERR 

.ENDC 

•ENDM CMKT?C 



$$$-. 
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C.2.20 CMKT$S Macro 



The CMKT$S macro generates the code to push a DPB for the CANCEL 
MARK-TIME REQUESTS directive on the stack followed by an EMT 377. 

Macro call: CMKT$S EFN,AST,ERR 

Description: This macro generates the code to push a DPB for the 
CANCEL MARK-TIME REQUESTS directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the CMKT$ macro. The macro also generates an 
EMT 377. The DIR$ macro describes the ERR error service address. 

Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-llD. Despite the fact that they must be 
specified, the CMKT$S macro ignores them. 

.MACRO CMKT$S EFN, AST, ERR 

.MCALL DIR$ 

MOV (PC)+,-(SP) 

.BYTE 27. ,1 

DIR$ ,ERR 

.ENDM CMKT$S 



C.2.21 CMKT$ Macro 

The CMKT$ macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive. 

Macro call: CMKT$ EFN, AST 

Description: This macro generates a DPB for the CANCEL MARK-TIME 
REQUESTS directive. 

Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-llD. Despite the fact that they must be 
specified, the CMKT$ macro ignores them. If the $$$GLB symbol is 
defined, this macro does not generate any code. 

.MACRO CMKT$ EFN, AST 
.IF NDF $$$GLB 
.BYTE 27. ,1 
.ENDC 
.ENDM CMKT$ 



C.2.22 CSRQ$C Macro 

The CSRQ$C macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: CSRQ$C TTASK,RTASK,PSCT,ERR 

Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive in the $DPB$$ program section. The DPB parameters 
are described in the CSRQ$ macro. Then the macro generates an EMT 377 
in the original program section named in PSCT. The DIR$ macro 
describes the ERR error service address. The CSRQ$ macro controls 
symbolic address generation. 
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Note: Read the discussion notice concerning ignored arguments in the 
CSRQ$ macro below. 

.MACRO CSRQ$C TT,RT,CS,ERR 
.MCALL CSRQ$,DIR$ 
.IF NDP $$$GLB 
.PSECT $DPB$$ 



?$$ = 



.IFTF 

CSRQ$ TT,RT 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM CSRQ$C 



C.2.23 CSRQ$S Macro 



The CSRQ$S macro generates the code to push a DPB for the CANCEL 
SCHEDULED REQUESTS directive on the stack followed by an EMT 377. 

Macro call: CSRQ$S TNAMADR,RNAMADR,ERR 

Description: This macro generates the code to push a DPB for CANCEL 
SCHEDULED REQUESTS on the stack. The TNAMADR and RNAMADR arguments 
must be valid assembler source operands that yield the addresses of 
double-words containing the RADIX-50 names specified in the CSRQ$ 
macro. The macro then generates an EMT 377. The DIR$ macro describes 
the ERR error service address. 

Note: Read the discussion notice concerning ignored arguments in the 
CSRQ$ macro below. 

.MACRO CSRQ$S TN,RN,ERR 

.MCALL RFA$,DIR$ 

RFA$ TN 

MOV (PC)+,-(SP) 

.BYTE 25., 3 

DIR$ ,ERR 

.ENDM CSRQ$S 



C.2.24 CSRQ$ Macro 

The CSRQ$ macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive. 

Macro call: CSRQ$ TTASK,RTASK 

Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive. The arguments are assumed to have the following 
meanings: 

TTASK=Scheduled (target) task name, 
RTASK=Scheduler (requester) task name. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

C.SRTN- (length 4 bytes) target task name, 
C.SRRN-(4) requester task name. 
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If the macro is invoked with the $$$GLB symbol defined, CSRQ$ does not 
generate the DPB and it globally defines the symbolic offsets. 

Note: The RTASK argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the CSRQ$ macro 
ignores it. 

.MACRO CSRQ$ TT,RT 

.MCALL R50$,OFF$ 

.IF NDF $$$GLB 

.BYTE 25., 3 

R50$ TT 

.ENDC 

.IF NDF C.SRTN 

.NLIST 

OFF$ 

OFF$ C.SRTN, 4 

OFF$ C.SRRN,4 

.LIST 

.ENDC 

.ENDM CSRQ$ 



C.2.25 DECL$C Macro 

The DECL$C macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program section. 

Macro call: DECL$C EFN,PSCT,ERR 

Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive in the $DPB$$ program section. This macro also 
generates an EMT 377 in the user specified program section, PSCT, with 
the ERR error service address as described in the DIR$ macro. 

Note» The EFN argument is required to maintain compatibility with 
RSX-ilD. Despite the fact that it must be specified, the DECL$C macro 
ignores it. 

.MACRO DECL$C EFN, PSCT, ERR 
.MCALL DECL$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$ = 



.IFTF 

DECL$ EFN 

.IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

•ENDM DECL$C 



C.2.26 DECL$S Macro 



The DECL$S macro generates the code to push a DPB for the DECLARE 
SIGNIFICANT EVENT directive on the stack followed by an EMT 377. 

Macro call: DECL$S EFN, ERR 
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Description: This macro generates the code to push a DPB for the 
DECLARE SIGNIFICANT EVENT directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the DECL$ macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIR$ macro. 

Note: The EFN argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the DECL$ macro 
ignores it. 

.MACRO DECL$S EFN, ERR 
.MCALL DIR? 
MOV (PC)+,-(SP) 
•BYTE 35., 1 
DIR$ ,ERR 
.ENDM DECL$S 



C.2.27 DECL$ Macro 

The DECL$ macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive. 

Macro call: DECL$ EFN 

Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive. DECL$ ignores the EFN argument but EFN must be 
present to maintain compatibility with RSX-llD. 

.MACRO DECL$ EFN 
.IF NDF $$$GLB 
.BYTE 35., 1 
. ENDC 
.ENDM DECL? 



C.2.28 DIR$ Macro 

DIR$ generates an RSX-llM directive call (EMT 377) with a pre-defined 
DPB. 

Macro call: DIR$ ADR, ERR 

Description: The argument, ADR, must be a valid assembler source 
operand. It pushes the DPB address on the stack. DIR? then generates 
an EMT 377 to trap to the Executive. The argument, ERR, is optional. 
If ERR is defined, it must be a valid assembler destination operand to 
permit the execution of a JUMP TO SUBROUTINE instruction to an error 
handler if the directive CALL fails. 

.MACRO DIR$ ADR, ERR 

.IF NB <ADR> 

MOV ADR,-(SP) 

.ENDC 

EMT "0<377> 

.IIF NB <ERR>, .MCALL ERR? 

.IIF NB <ERR>, ERR? ERR 

.ENDM DIR? 
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C.2.29 DSAR$C Macro 

The DSAR$C macro generates the DPB for the DISABLE AST RECOGNITION 
directive in a separate program section followed by an EMT 377 in the 
user specified PSECT. 

Macro call: DSARSC PSCT,ERR 

Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive in the PSECT $DPB$$ followed by an EMT 377 in 
the program section specified in PSCT. The DIR$ macro describes the 
ERR error service address. 

.MACRO DSAR$C PSCT, ERR 
.MCALL DSAR$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$* 



• IFTF 
DSAR$ 

• IFT 

.PSECT PSCT 
DIR$ #$$$,ERR 
.ENDC 

.ENDM DSAR$C 



C.2.30 DSAR$S Macro 



The DSAR$S macro generates the code to push a DPB for the DISABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 

Macro call: DSAR$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377, using the ERR error service address, described 
in the DIR$ macro. 

.MACRO DSAR$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 99., 1 
DIR$ ,ERR 
.ENDM DSAR$S 



C.2.31 DSAR$ Macro 

The DSAR$ macro generates a DPB for the DISABLE AST RECOGNITION 
directive. 

Macro call: DSAR$ 

Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive. 

.MACRO DSAR$ 

.IF NDF $$$GLB 

.BYTE 99., 1 

.ENDC 

.ENDM DSAR$ 
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C.2.32 DSGP$C Macro 

The DSCP$C macro generates a DPB for the DISABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: DSCP$C PSCT, ERR 

Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive in the $DPB$$ program section and an EMT 377 in the user 
specified PSCT program section. The DIR$ macro describes the ERR 
error service address. 

.MACRO DSCP$C PSCT, ERR 
•MCALL DSCP$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$ = 



.IFTF 

DSCP? 

.IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM DSCP$C 



C.2.33 DSCP$S Macro 

The DSCP$S macro generates the code to push a DPB for the DISABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 

Macro call: DSCP$S ERR 

Description: This macro generates the code to push a one-word DPB for 

the DISABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 

generated, using the ERR error service address, as described in the 
DIR$ macro. 

.MACRO DSCP$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 95., 1 
DIR$ ,ERR 
•ENDM DSCP$S 



C.2.34 DSCP$ Macro 

The DSCP$ macro generates a DPB for the DISABLE CHECKPOINTING 
directive. 

Macro call: DSCP$ 

Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive. There are no arguments. 

.MACRO DSCP$ 
.IF NDF $$$GLB 
.BYTE 95., 1 
.ENDC 
.ENDM DSCP$ 
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C.2.35 ENAR$C Macro 

The ENAR$C macro generates a DPB for the ENABLE AST RECOGNITION 
directive in a separate PSECT, followed by an EMT 377 m the user 
specified PSECT. 

Macro call: ENAR$C PSCT,ERR 

Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive in the $DPB$$ program section followed by an EMT 
377 in the program section named in PSCT. The DIR$ macro describes 
the ERR error service address, 

.MACRO ENAR$C PSCT, ERR 
•MCALL ENAR$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$' 



.IFTF 

ENAR$ 

• IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM ENAR$C 



C.2.36 ENAR$S Macro 



The ENAR$S macro generates the code to push a DPB for the ENABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 

Macro call: ENAR$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the ENABLE AST RECOGNITION directive on the stack. Then an EMT 377 is 
generated using the ERR error service address as described in the DIR$ 
macro. 

.MACRO ENAR$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 101., 1 
DIR$ ,ERR 
.ENDM ENAR$S 



C.2.37 ENAR$ Macro 

The ENAR$ macro generates a DPB for the ENABLE AST RECOGNITION 
directive. 

Macro call: ENAR$ 

Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive. There are no parameters. 

MACRO ENAR$ 
.IF NDF $$$GLB 
.BYTE 101., 1 
• ENDC 
.ENDM ENAR$ 
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C.2.38 ENCP$C Macro 

The ENCP$C macro generates a DPB for the ENABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program PSECT. 

Macro call: ENCP$C PSCT,ERR 

Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive in the $DPB$$ program section. Then the macro generates an 
EMT 377 in the program section named in PSCT. The DIR$ macro 
describes the ERR error service address. 

.MACRO ENCP$C PSCT, ERR 
.MCALL ENCP$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$' 



.IFTF 

ENCP$ 

,IFT 

•PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM ENCP$C 



C.2.39 ENCP$S Macro 



The ENCP$S macro generates the code to push a DPB for the ENABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 

Macro call: ENCP$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the ENABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 
generated using the ERR error service address as described in the DIR$ 
macro. 

.MACRO ENCP$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 97., 1 
DIR$ ,ERR 
.ENDM ENCP$S 



C.2.40 ENCP$ Macro 

The ENCP$ macro generates a DPB for the ENABLE CHECKPOINTING 
directive. 

Macro call: ENCP$ 

Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive. There are no parameters 

.MACRO ENCP$ 
.IF NDF $$$GLB 
.BYTE 97. ,1 
.ENDC 
.ENDM ENCP$ 
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C.2.41 ERR$ Macro 

ERR$ is an internal macro that generates a test for directive failure 
accompanied by a JSR instruction to an error handler. 

Macro call: ERR$ ERR 

Description: A set C-bit indicates directive failure. If the ERR 
argument is defined, ERR$ generates code to test the C-bit and skip if 
not set followed by a JSR to an error handler specified by ERR. 

.MACRO ERR$ ERR 

.IF NB <ERR> 

.NLIST 

•NTYPE $$$Tl,ERR 

LIST 
!lIF EQ "0<$$$Tl-27>, BCC .+6 
.IIF EQ "0<$$$Tl-37>, BCC .+6 
.IF GE ~O<$$$Tl-60> 
BCC .+6 
.IFF 

.IF NE "0<$$$Tl-27> 
.IIF NE ~0<$$$Tl-37>, BCC .+4 
.ENDC 
.ENDC 
CALL ERR 
• ENDC 
.ENDM ERR$ 



C.2.42 EXIF$C Macro 

THE EXIF$C macro generates a DPB for the EXIT IF directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 

Macro call: EXIF$C EFN,PSCT,ERR 

Description: This macro generates a DPB for the EXIT IF directive in 
the $DPB$$ program section. The DPB parameters are described in the 
EXIF$ macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The EXIF$ macro controls symbolic address generation. 

.MACRO EXIF$C EFN,CS,ERR 
.MCALL EXIF$,DIR$ 
.IF NDF $$$GLB 
•PSECT $DPB$$ 



$$$ = 



.IFTF 

EXIF$ EFN 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM EXIF$C 
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C.2.43 EXIF$S Macro 

The EXIF$S macro generates the code to push a DPB for the EXIT IF 
directive on the stack followed by an EMT 377. 

Macro call: EXIF$S EFN,ERR 

Description: This macro generates the code to push a DPB for the EXIT 
IF directive on the stack. The DPB arguments must be valid assembler 
source operands, and they must specify the information described in 
the EXIF$ macro. This macro also generates an EMT 377 using the ERR 
error service address as described in the DIR$ macro. 

.MACRO EXIF$S EFN,ERR 

.MCALL MOV$,DIR$ 

MOV$ EFN 

MOV (PC)+,-(SP) 

.BYTE 53., 2 

DIR$ ,ERR 

•ENDM EXIF$S 



C.2.44 EXIF$ Macro 

The EXIF$ macro generates a DPB for the EXIT IF directive. 

Macro call: EXIF$ EFN 

Description: This macro generates a DPB for the EXIT IF directive. 
The argument is assumed to have the following meaning: 

EFN=Event flag number. 

The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 

E.XFEF- (length 2 bytes) Event flag number. 

If the macro is invoked with the symbol $$$GLB defined, EXIF$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO EXIF$ EFN 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 53. ,2 

.WORD EFN 

.ENDC 

.IF NDF E.XFEF 

.NLIST 

OFF$ 

OFF$ E.XFEF,2 

.LIST 

.ENDC 

.ENDM EXIF$ 



C.2.45 EXITSC Macro 

The EXIT$C macro generates a DPB for the TASK EXIT directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: EXIT$C PSCT,ERR 
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Description: This macro generates a DPB in the program SECTION $DPB$$ 
followed by an EMT 377 in the PSCT program section. The DIR$ macro 
describes the ERR error service address. 

.MACRO EXIT$C PSCT, ERR 
.MCALL EXIT$,DIR$ 
.IF NDF $$$GLB 
•PSECT $DPB$$ 



$$$ = 



.IFTF 

EXIT? 

.IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM EXIT$C 



C.2.46 EXIT$S Macro 



The EXIT$S macro generates the code to push a DPB for the TASK EXIT 
directive on the stack followed by an EMT 377. 

Macro call: EXIT$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the TASK EXIT directive on the stack. Then, EXIT$S generates an EMT 
377 using the ERR error service address, as described in the EXIT$ 
macro. 

.MACRO EXITSS ERR 

.MCALL DIR? 

MOV (PC)+,-(SP) 

.BYTE 51., 1 

DIR$ 

.IIF NB <ERR>, CALL ERR 

.ENDM EXIT$S 



C.2.47 EXIT$ Macro 

The EXIT$ macro generates a DPB for the TASK EXIT directive. 

Macro call: EXIT$ 

Description: This macro generates a DPB for the TASK EXIT directive. 
There are no parameters. 

•MACRO EXIT$ 
.IF NDF $$$GLB 
.BYTE 51. ,1 
• ENDC 
.ENDM EXIT$ 

C.2.4 8 EXTK$C Macro 

The EXTK$C macro generates a DPB for the EXTEND TASK directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: EXTK$C INC, PSCT, ERR 
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Description: This macro generates a DPB for the EXTEND TASK directive 
in the $DPB$$ program section. The DPB parameters are described in 
the EXTK$ macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The EXTK$ macro controls the generation of symbolic offsets. 

•MACRO EXTK$C INC, CS, ERR 
.MCALL EXTK$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$-. 
.IFTP 
EXTK$ INC 
.IFT 

•PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
•ENDM EXTK$C 



C.2.49 EXTK$S Macro 

EXTK$S pushes a DPB for the EXTEND TASK directive on the stack and 
generates an EMT 377. 

Macro call: EXTK$S INC, ERR 

Description: EXTK$S pushes a DPB for the EXTEND TASK directive on the 
stack. The DPB arguments must be valid assembler operands and they 
must specify the information that the EXTK$ macro describes. EXTK$S 
also generates an EMT 377 using the ERR error service address that the 
DIR$ macro describes. 

.MACRO EXTK$S INC, ERR 

.MCALL MOV$,DIR$ 

CLR -(SP) 

MOV$ INC 

MOV (PC)+,-(SP) 

.BYTE 89., 3 
DIR$ ,ERR 

.ENDM EXTK$S 



C.2..50 EXTK$ Macro 

The EXTK$ macro generates a DPB for the EXTEND TASK directive. 

Macro call: EXTK$ INC 

Description: EXTK$ generates a DPB for the EXTEND TASK directive. 
The argument must have the following meaning: 

INC=Task size increment in 32 word blocks. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

E.XTIN- (length 2 bytes) Task size increment. 
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If EXTK5 is invoked with the $$$GLB symbol defined, EXTK$ does not 
generate the DPB and it globally defines symbolic offsets. 

.MACRO EXTK$ INC 

.MCALL OFF$ 

•IF NDF $$$GLB 

.BYTE 89., 3 

.WORD INC 

.WORD 

• ENDC 

.IF NDF E.XTIN 

.NLIST 

OFF$ 

OFF$ E.XTIN, 2 

.LIST 

.ENDC 

.ENDM EXTK$ 



C.2.51 GLUN$C Macro 

GLUN$C generates a DPB for the GET LUN INFORMATION directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 

Macro call: GLUN$C LUN,BUFADR,PSCT,ERR 

Description: GLUN$C generates a DPB for the GET LUN INFORMATION 
directive in the $DPB$$ program section and generates an EMT 377 in 
the program section named in PSCT. GLUN$ describes the DPB parameters 
and controls symbolic address generation. The DIR$ macro describes 
the ERR error service address. 

.MACRO GLUN$C LUN ,BUFA,CS ,ERR 
•MCALL GLUN$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$-. 
.IFTF 

GLUN$ LUN,BUFA 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM GLUN$C 



C.2.52 GLDN$S Macro 

GLUN$S generates the code to push a DPB for the GET LUN INFORMATION 
directive on the stack and generates an EMT 377. 

Macro call: GLUN$S LUN,BUFADR,ERR 

Description: GLUN$S generates the code to push a DPB for the GET LUN 
INFORMATION directive on the stack and generates an EMT 377 by using 
the ERR error service address as described in the DIR$ macro. GLUN$S 
also generates symbolic offsets relative to the information buffer as 
described in the GLUN$ macro. DPB arguments must be valid assembler 
source operands and must specify the information described in the 
GLUN$ macro. 
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.MACRO GLUN$S LUN ,BUFA,ERR 
.MCALL MOV$,DIR$,OFF$ 
MOV$ BUFA 
MOV$ LUN 
MOV (PC)+,-(SP) 
.BYTE 5,3 
DIR$ ,ERR 
.IF NDF G.LUNA 
.NLIST 
SSSOST^O 

.IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8.>> 

OFF$ X 
.ENDM 

• LIST 

• ENDC 

.ENDM GLUN$S 



C.2.53 GLUN$ Macro 

The GLUN$ macro generates a DPB for the GET LUN INFORMATION directive. 

Macro call: GLUN$ LUN r BUFADR 

Description: This macro generates a DPB for the GET LUN INFORMATION 
directive. The arguments are assumed to have the following meaning: 

LUN=Logical unit number, 
BUFADR=Address of six-word buffer. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

G. LULU- (length 2 bytes) Logical unit number, 
G.LUBA-(2) Buffer address, 
G.LUBL-(2) Buffer length. 

The following symbols are assigned relative to the start of the LUN 
information buffer: 

G.LUNA- (2) Device name, 

G.LUNU-(l) Device unit number, 

G.LUFB-(l) Flags byte, 

G.LUCW-(8) Four device characteristic words. 

If the macro is invoked with the $$GLB symbol defined, GLUN$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO GLUN$ LUN, BUFA 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE 5,3 
.WORD LUN 
.WORD BUFA 
• ENDC 

.IF NDF G.LULU 
.NLIST 

.IRP X,<,<G.LULU,2>,<G.LUBA,2>,<G.LUBL,2>> 
OFF$ X 
.ENDM 

.IF NDF G.LUNA 
$$$OST=0 
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.IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8,>> 

OFF? X 

.ENDM 

.ENDC 

.LIST 

.ENDC 

.ENDM GLUN$ 



C.2.54 GMCR$C Macro 

GMCR$C generates a DPB for the GET MCR COMMAND LINE directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: GMCR$C PSCT,ERR 

Description: GMCR$C generates a DPB for the GET MCR COMMAND LINE 
directive in the $DPB$$ program section and generates an EMT 377 in 
the program section named in PSCT. GMCR$ describes the DPB parameters 
and controls symbolic address generation. DIR$ describes the ERR 
error service address. 

.MACRO GMCR$C CS,ERR 
.MCALL GMCR$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
GMCR$ 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM GMCR$C 



C.2.55 GMCR$ Macro 

The GMCR$ macro generates a DPB for the GET MCR COMMAND LINE 
directive. 

Macro call: GMCR$ 

Description: This macro generates a DPB for the GET MCR COMMAND LINE 
directive. GMCR$ locally defines the following symbol with its 
assigned value equal to the byte offset from the start of the DPB to 
the DPB element: 

G.MCRB- (length 80 bytes) MCR line buffer 

If the macro is invoked with the $$$GLB symbol defined, GMCR$ does not 
generate the DPB and it globally defines the symbolic offset. 

•MACRO GMCR$ 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 127. ,41. 

.BLKW 40. 

.ENDC 

.IF NDF G.MCRB 

.NLIST 

OFF$ 
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OFF$ G.MCRB,80, 

.LIST 

.ENDC 
' . ENDM GMCR$ 



C.2.56 GPRTSC Macro 



GPRT$C generates a DPB for the GET PARTITION PARAMETERS directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: GPRT$C PRTNAM,BUFADR,PSCT,ERR 

Description: GPRT$C generates a DPB for the GET PARTITION PARAMETERS 
directive in the $DPB$$ program section and generates an EMT 377 in 
the program section named in PSECT. GPRT$ describes the DPB 
parameters and controls symbolic offset generation. DIR$ describes 
the ERR error service address. 

.MACRO GPRT$C PRT ,BUF,CS ,ERR 
.MCALL GPRT$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
• IFTF 

GPRT$ PRT,BUF 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
. ENDC 
.ENDM GPRT$C 



C.2.57 GPRT5S Macro 

GPRT$S generates the code to push a DPB for the GET PARTITION 
PARAMETERS directive on the stack and generates an EMT 377. 

Macro call: GPRT$S PRTNAMADR,BUFADR,ERR 

Description: GPRT$S generates the code to push a DPB for the GET 
PARTITION PARAMETERS directive on the stack and generates an EMT 377 
using the ERR error service address described in the DIR$ macro. The 
DPB arguments must be valid assembler source operands and they must 
specify the information described in the GPRT$ macro. GPRT$S also 
generates symbolic offsets relative to the start of the partition 
parameters buffer described in the GPRT$ macro. 

.MACRO GPRT$S PRT,BUF f ERR 
.MCALL MOV$,RFA$,DIR$,OFF$ 
MOV$ BUF 
RFA$ PRT 
MOV (PC)+,-(SP) 
.BYTE 65., 4 
DIR$ ,ERR 
.IF NDF G.PRPB 
.NLIST 
$$$OST=0 

.IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 
OFF$ X 
.ENDM 
• LIST 
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.ENDC 

.ENDM GPRT$S 



C.2.58 GPRT$ Macro 

The GPRT$ macro generates a DPB for the GET PARTITION PARAMETERS 
directive . 

Macro call: GPRT$ PRTNAM,BUF 

Description: This macro generates a DPB for the GET PARTITION 
PARAMETERS directive. The arguments are assumed to have the following 
meanings: 

PRTNAM=Partition name, 
BUFADR=Address of three word buffer. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

G.PRPN- (length 4 bytes) Partition name, 
G.PRBA-(2) Buffer address. 

The following offsets are assigned relative to the start of the 
partition parameters buffer: 

G.PRPB-(2) 1/64 Partition base address, 
G.PRPS-(2) 1/64 Partition size, 
G.PRFW-(2) Partition flags word. 

If GPRT$ is invoked with the $$$GLB symbol defined, GPRT$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO GPRT$ PRT,BUF 
.MCALL OFF$,R50$ 
.IF NDF $$$GLB 

• BYTE 65. ,4 
R50$ PRT 
.WORD BUF 
.ENDC 

.IF NDF G.PRPN 
•NLIST 
OFF$ 

OFF$ G.PRPN, 4 
OFF$ G.PRBA,2 
.IF NDF G.PRPB 
$$$OST=0 

•IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 

OFF$ X 

.ENDM 

.ENDC 

• LIST 
.ENDC 
.ENDM GPRT$ 
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C.2.59 GSSW5C Macro 

The GSSW$C macro generates a DPB for the GET SENSE SWITCHES directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 

Macro call: GSSW$C PSCT,ERR 

Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive in the $DPB$$ program section followed by an EMT 377 in the 
user specified program section PSCT. The DIR$ macro describes the ERR 
error service address. 

•MACRO GSSW$C PSCT, ERR 
.MCALL GSSW$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
GSSW$ 
.IFT 

.PSECT PSCT 
DIR$ #$$$,ERR 
.ENDC 
.ENDM GSSW$C 



C.2.60 GSSW$S Macro 

The GSSW$S macro generates the code to push a DPB for the GET SENSE 
SWITCHES directive on the stack followed by an EMT 377. 

Macro call: GSSW$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the GET SENSE SWTICHES directive on the stack. Then it generates an 
EMT 377 using the error service address as described in the DIR$ 
macro. 

.MACRO GSSW$S ERR 
•MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 125., 1 
DIR$ ,ERR 
.ENDM GSSW$S 



C.2.61 GSSW$ Macro 

The GSSW$ macro generates a DPB for the GET SENSE SWITCHES directive. 

Macro call: GSSW$ 

Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive. There are no arguments. 

.MACRO GSSW$ 
.IF NDF $$$GLB 
.BYTE 125., 1 
.ENDC 
.ENDM GSSW$ 
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C.2.62 GTIMSC Macro 

The GTIM$C macro generates a DPB for the GET TIME PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 

Macro call: GTIM?C BUFADR,PSCT,ERR 

Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive in the $DPB$$ program section. The GTIM$ macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The GTIM$ macro controls symbolic address 
generation. 

.MACRO GTIM$C BUFA,CS ERR 
.MCALL GTIM$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$-. 
.IFTF 

GTIM$ BUFA 
.IFT 

.PSECT CS 
DIR$ #$??,ERR 
.ENDC 
•ENDM GTIM$C 



C.2.63 GTIM$S Macro 

The GTIM$S macro generates the code to push a DPB for the GET TIME 
PARAMETERS directive on the stack followed by an EMT 377. 

Macro call: GTIM$S BUFADR,ERR 

Description: This macro generates the code to push a DPB for the GET 
TIME PARAMETERS directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the GTIM$ macro. This macro also generates an EMT 377 
using the ERR error service address, as described in the DIR? macro. 
This macro also generates symbolic offsets relative to the time 
parameters buffer as described in the GTIM$ macro. 

•MACRO GTIM$S BUFA, ERR 
.MCALL MOV$,DIR$,OFF$ 
MOV? BUFA 
MOV (PC)+,-{SP) 
.BYTE 61. ,2 
DIR$ ,ERR 
.IF NDF G.TIYR 
.NLIST 
$$ $OST = 

.IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 

OFF? X 

.ENDM 

.IRP X,<<G.TIMI,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 

OFF? X 

.ENDM 

.LIST 

.ENDC 

.ENDM GTIM?S 
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C.2.64 GTIM$ Macro 

The GTIM$ macro generates a DPB for the GET TIME PARAMETERS directive. 

Macro call: GTIM$ BUFADR 

Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive. The argument is assumed to have the following meaning: 

BUFADR=Address of eight word buffer. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the element: 

G.TIBA- (length 2 bytes) Buffer address. 

The following offsets are assigned relative to the start of the time 
parameters buffer: 

G.TIYR-(2) Year, 

G.TIM0-(2) Month, 

G.TIDA-(2) Day, 

G.TIHR-(2) Hour, 

G.TIMI-(2) Minute, 

G.TISC-(2) Second, 

G.TICT-(2) Clock tick, 

G.TICP-(2) Clock ticks per second. 

If GTIM$ is invoked with the $$$GLB symbol defined, GTIM$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO GTIM$ BUFA 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE 61. ,2 
.WORD BUFA 
.ENDC 

.IF NDF G.TIBA 
.NLIST 
OFF$ 

OFF$ G.TIBA, 2 
.IF NDF G.TIYR 
$$$OST=0 

.IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 

OFF$ X 

.ENDM 

.IRP X,<<G.TIMI,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 

OFF$ X 

.ENDM 

.ENDC 

.LIST 

.ENDC 

•ENDM GTIM$ 



C.2.65 GTSK$C Macro 

The GTSK$C macro generates a DPB for the GET TASK PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 

Macro call: GTSK$C BUFADR, PSCT, ERR 
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Description: This macro generates a DPB for the GET TASK PARAMETERS 
directive in the $DPB$$ program section. The GTSK$S macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
original program control section named in PSCT. The DIR$ macro 
describes the ERR error service address. The GTSK$ macro controls 
symbolic offset generation. 

•MACRO GTSK$C BUFA,CS,ERR 
.MCALL GTSK$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

$$$-. 
.IFT 

GTSK$ BUFA 
.IFT 

•PSECT CS 
DIR$ #$$$,ERR 
• ENDC 
.ENDM GTSK$C 



C.2.66 GTSK$S Macro 

The GTSK$S macro generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack followed by an EMT 377. 

Macro call: GTSK$S BUFADR,ERR 

Description: GTSK$S generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack. The DPB arguments must be valid 
assembler source operands and they must specify the information 
described in the GTSK$ macro. GTSK$S generates an EMT 377 using the 
ERR error service address, as described in the DIR$ macro. GTSK$S 
also generates symbolic offsets relative to the task parameters buffer 
as described in the GTSK$ macro. 

.MACRO GTSK$S BUFA, ERR 

.MCALL MOV$,DIR$,OFF$ 

MOV$ BUFA 

MOV (PC)+,-(SP) 

.BYTE 63. ,2 

DIR$ ,ERR 

.IF NDF G.TSTN 

.NLIST 

$$ $OST— 

.IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 

OFF$ X 

.ENDM 

.IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 

VL,2 

OFF$ G.TSTS,2 

OFF$ G.TSSY,2 

OFF? G.TSDU,2 

$$$0ST=0 

.IRP X,<<RX$11D,1>,<RX$11M,1>,<RX$11S,1>,<RX$IAS,1>> 

OFF$ X 

.ENDM 

.LIST 

.ENDC 

.ENDM GTSK$S 
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C.2.67 GTSK$ Macro 

The GTSK$ macro generates a DPB for the GET TASK PARAMETERS directive. 

Macro call: GTSK$ BUFADR 

Description: GTSK? generates a DPB for the GET TASK PARAMETERS 
directive. The argument is assumed to have the following meaning: 

BUFADR=Address of a 16 word buffer. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

G.TSBA- (length 2 bytes) Buffer address. 

The following offsets are assigned relative to the start of the task 
parameters buffer: 



G.TSTN-(4 
G.TSPN-(4 
G.TSRN-(4 
G.TSPR-<2 
G.TSGC-(1 
G.TSPC-U 
G.TSNL-(2 
G.TSMT-(2 
G.TSFW-{2 
G.TSVA-(2 
G.TSVL-{2 
G.TSTS-(2 
G.TSSY-(2 



Task name 

Partition nctme 

Name of task's requester 

Priority 

UIC group code 

UIC programmer code 

Number of logical units 

Machine types 

Std flags word 

Address of task SST vector table 

Length (number of words) of task SST vector table 

Size (in bytes) of task address space 

System in which task is running: 
RX$11D - System is RSX-llD 
RX$11M - System is RSX-llM 
RX$11S - System is RSX-11S 
RX$IAS - System is IAS 
G.TSDU-{2) Task's (default) protection UIC 

If GTSK$ is invoked with the $$$GLB symbol defined, GTSK$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO GTSK$ BUFA 

.MCALL OFF$ 

•IF NDF $$$GLB 

.BYTE 63. ,2 

.WORD BUFA 

. ENDC 

.IF NDF G.TSBA 

.NLIST 

OFF$ 

OFF$ G.TSBA, 2 

.IF NDF G.TSTN 
$$$OST=0 

.IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 

OFF$ X 

.ENDM 

.IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 

OFF$ X 

.ENDM 

OFF$ G.TSVL,2 

OFF$ G.TSTS,2 

OFF$ G.TSSY,2 

OFF$ G.TSDU,2 
$$$OST=0 
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.IRP X,<<RX$11D,1>,<RX$11M,1>,<RX$11S,1>,<RX$IAS,1>> 

OFF$ X 

.ENDM 

• ENDC 
.LIST 

• ENDC 
.ENDM GTSK$ 



C.2.68 IHAR$C Macro 

The IHAR$C macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in a separate PSECT followed by an EMT 377 in 
the user specified PSECT. 

Macro call: IHAR$C PSCT,ERR 

Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in the $DPB$$ program section followed by an EMT 
377 in the user specified program section named PSCT. The DIR$ macro 
describes the ERR error service address. 

Note: This macro is the same as the DSAR$C macro, and is included 
only for compatibility with RSX-11D. 

.MACRO IHAR$C PSCT, ERR 
.MCALL DSAR$C 
DSAR$C PSCT, ERR 
.ENDM IHAR$C 



C.2.69 IHAR$S Macro 

The IHAR$S macro generates the code to push a DPB for the INHIBIT AST 
RECOGNITION directive on the stack and an EMT 377. 

Macro call: IHAR$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377 using the ERR error service address described in 
the DIR$ macro. 

Note: This macro is included only for compatibility with RSX-llD. 

.MACRO IHAR$S ERR 
•MCALL DSAR$S 
DSAR$S ERR 
.ENDM IHAR$S 



C.2.70 IHAR$ Macro 

The IHAR$ macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. 

Macro call: IHAR$ 

Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. There are no parameters. 
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Note: This macro is included- only for compatiblity with RSX-11D. 

.MACRO IHAR$ 
.MCALL DSAR$ 
DSAR$ 
.ENDM IHAR$ 



C.2.71 MOV$ Macro 

This is an internal macro that pushes an argument on the stack. 

Macro call: MOV$ <ARG> 

Description: MOV$ pushes an argument on the stack. MOV$ examines the 
argument first to determine which code is valid to perform the push. 
If the argument is left blank, MOV$ uses a CLR instruction. 
Otherwise, MOV$ generates a "MOV ARG,-(SP)" instruction. 

.MACRO MOVS ARG 

.IF NB <ARG> 

.IF DIF <ARG>,<#0> 
MOV ARG,-(SP) 

.MEXIT 

.ENDC 

.ENDC 
CLR -(SP) 

.ENDM MOV$ 



C.2.72 MRKT$C Macro 

The MRKT$C macro generates a DPB for the MARK TIME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: MRKT$C EFN,TIMMAG,TIMUNIT,AST,PSCT,ERR 

Description: This macro generates a DPB for the MARK TIME directive 
in the $DPB$$ program section. The MRKT$ macro describes the DPB 
parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The MRKT$ macro controls the generation of symbolic offsets. 

.MACRO MRKT$C EF, TM,TU ,AST,CS ,ERR 
•MCALL MRKT$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$? 
$$$=. 

• IFTF 

MRKT$ EF,TM,TU,AST 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 

• ENDC 

•ENDM MRKT$C 
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C.2.73 HRKT$S Macro 

The MRKT$S macro generates the code to push a DPB for the MARK TIME 
directive on the stack followed by an EMT 377. 

Macro call: MRKT$S EFN f TIMMAG,TIMUNIT,AST,ERR 

Description: This macro generates the code to push a DPB for the MARK 

TIME directive on the stack. The DPB arguments must be valid 

assembler source operands and they must specify the information 

described in the MRKT$ macro. This macro also generates an EMT 377 

using the ERR error service address as described in the DIR$ macro. 

•MACRO MRKT$S EF,TM,TU ,AST,ERR 

.MCALL RVP$,DIR$ 

RVP$ EF,TM,TU,AST 

MOV (PC)+,-(SP) 

.BYTE 23., 5 

DIR$ ,ERR 

.ENDM MRKT$S 



C.2.74 MRKT$ Macro 

The MRKT$ macro generates a DPB for the MARK TIME DIRECTIVE. 

Macro call: MRKT$ EFN ,TIMMAG,TIMUNIT,AST 

Description: This macro generates a DPB for the MARK TIME directive. 
The arguments are assumed to have the following meanings: 

EFN=Event flag number, 
TIMMAG*Time interval magnitude, 
TIMUNIT=Time interval unit, 
AST=*AST entry address. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

M.KTEF- (length 2 bytes) Event flag, 
M.KTMG-(2) Time magnitude, 
M.KTUN-(2) Time unit, 
M.KTAE-(2) AST entry address. 

If MRKT$ is invoked with the $$$GLB symbol defined, MRKT$ does not 
generate the DPB and globally defines the symbolic offsets. 

.MACRO MRKT$ EFN ,TM,TU ,AST 

.MCALL OFF$ 

.IF NDF $$$GLB 

• BYTE 23., 5 

•WORD EFN 

.WORD TM 

.WORD TU 

.WORD AST 

.ENDC 

.IF NDF M.KTEF 

.NLIST 

•IRP X,<,<M.KTEF,2>,<M.KTMG,2>,<M.KTUN,2>,<M.KTAE,2>> 

OFF$ X 

.ENDM 

.LIST 
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.ENDC 
.ENDM MRKT$ 



C.2.75 MVB$ Macro 

MVB$ is an internal macro that pushes two bytes on the stack. 

Macro call: MVB$ LQWB,HIGHB 

Description: MVB$ examines the two arguments and based on that 
examination generates the code to push the bytes on the stack. 

.MACRO MVB$ LOW, HIGH 

.IF B <LOW> 

•IF B <HIGH> 

CLR -(SP) 

.IFF 

CLRB -(SP) 

MOVB HIGH,1 (SP) 

• ENDC 
.IFF 

.IF B <HIGH> 
CLR -(SP) 
MOVB LOW, (SP) 

.IFF 

MOVB LOW,-(SP) 

MOVB HIGH,1(SP) 

• ENDC 
.ENDC 
.ENDM MVB$ 



C.2.76 OFF$ Macro 

OFF$ is an internal macro that generates symbolic offsets. 

Macro call: OFF$ SYMB,LEN 

Description: OFF$ creates tables of symbolic offsets for the elements 
within DPBs. The first argument, SYMB, is the name of the symbol. 
The second argument, LEN, is the length of the symbol in bytes. OFF$ 
adds LEN to the offset counter after OFF? makes the symbolic 
assignment. If the $$$GLB symbol is defined, OFF$ makes the symbolic 
assignments global. Otherwise, OFF$ makes all assignments local. 

If both SYMB and LEN are blank, OFF$ initializes the offset counter to 
two (2) . 

.MACRO OFF$ SYMB, LEN 

.IF B <'SYMB'LEN> 
$$$OST=2 

.MEXIT 

.ENDC 

.IF NB <SYMB> 

.IF NDF $$$GLB 
SYMB=$$$OST 

.IFF 
SYMB==$$$OST 

.ENDC 

• ENDC 
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C.2.77 QDPB$S Macro 

The QDPB$S macro generates the code to push a QUEUE I/O or QUEUE I/O 
AND WAIT DPB on the stack and it generates an EMT 377. 

Macro call: QDPB$S DIC,FNC ,LUN,EFN,PRI ,IQST, AST, PRMLST, ERR 

Description: This macro generates the code to push the proper QUEUE 
I/O DPB on the stack. It is meant to be called only by QIO$S, or 
QIOW$S to generate the required code to build a DPB and issue the EMT 
377. 

.MACRO QDPB$S DIC, FNC ,LUN , EFN ,PRI ,IOST, AST, PRMLST, ERR 

.MCALL RVP$,MVB$,DIR$ 

•NLIST 
$$$ARG=0 

.IRP X,<PRMLST> 
$$$ARG=$$$ARG+1 

.ENDM 
LIST 

JF GT 6-$$$ARG 

.REPT <6-$$$ARG> 

CLR -(SP) 
. .ENDR 

.ENDC 

.IIF NB <PRMLST>, RVP$ PRMLST 

RVP$ IOST,AST 

MVB$ EFN, 

RVP$ FNC,LUN 

MOV (PC)+,-(SP) 

.BYTE DIG, 12. 

DIR$ ,ERR 

.ENDM QDPB$S 



C.2.78 QDPB$ Macro 

The QDPB$ macro generates the QUEUE I/O or QUEUE I/O AND WAIT DPB. 

Macro call: QDPB$ DIC,FNC,LUN , EFN ,PRI ,IOST, AST, PRMLST 

Description: This macro generates the required DPB for the specified 
QUEUE I/O directive. It is only meant to be called by the QIO? , 
QIO$C, QIOW$, OR QIOW$C macros to generate the required DPB. 

.MACRO QDPB$ DIC , FNC ,LUN , EFN ,PRI ,IOST , AST , PRMLST 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE DIC, 12. 
.WORD FNC 
.WORD LUN 
.BYTE EFN,0 
•WORD IOST 
.WORD AST 
•NLIST 
$$$ARG=0 

• LIST 

.IRP X,<PRMLST> 
•WORD X 
.NLIST 
$$$ARG=$$$ARG+1 

• LIST 
.ENDM 
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.IF GT 6-$$$ARG 
•REPT <6-$$$ARG> 
.WORD 
.ENDR 

• ENDC 
.ENDC 

.IF NDF Q.IOFN 

.NLIST 

. I RP X , < , <Q . IOFN , 2 > , <Q . IOLU ,2>,<Q.IOEF,l>,<Q. IOPR , 1 > > 

OFF$ X 

• ENDM 

.IRP X,<<Q.IOSB,2>,<Q.IOAE,2>,<Q.IOPL>> 
OFF$ X 

• ENDM 
.LIST 
.ENDC 
.ENDM QDPB$ 



C.2.79 QIO$C Macro 

The QIO$C macro generates a QUEUE I/O DPB in a separate PSECT followed 
by an EMT 377 in the user specified PSECT. 

Macro call: QIO$C FNC,LUN,EFN ,PRI ,I05T, AST, PRMLST, PSECT, ERR 

Description: This macro generates the required QUEUE I/O DPB in the 
$DPB$$ program section. All of the arguments through PRMLST are as 
described for the QIO$ macro. The PSECT argument should be the name 
of the original program program section into which the standard 
monitor trap code is generated. The optional argument, ERR, is the 
error routine address. This macro invokes QIO$ and, therefore, 
follows the same expansion guidelines. 

Note: Read the note in the QIO$ macro description concerning ignored 
arguments in the QIO$ macro below. 

.MACRO QIO$C FNC,LUN,EFN,PRI,IOST, AST, PRMLST, PSCT, ERR 
.MCALL QDPB$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

• IFTF 

QDPB$ 1,FNC,LUN,EFN,PRI ,IOST,AST , <PRMLST> 

.IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM QIO$C 



C.2.80 QIO$S Macro 

The QIO$S macro generates the code to push a QUEUE I/O DPB on the 
stack and generate an EMT 377. 

Macro call: QIO$S FNC,LUN,EFN ,PRI ,IOST, AST, PRMLST, ERR 

Description: This macro generates the code to push the required queue 
I/O DPB on the stack. The arguments through PRMLST represent the 
information as described in the macro QIO$ . However, the arguments 
must all be valid assembler source operands. 
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Note: Read the note in the QIO$ macro description concerning ignored 
arguments in the QIO$ macro below. 

.MACRO QIO$S FNC, LUN, EFN, PRI, IOST, AST, PRMLST, ERR 
.MCALL QDPB$S 

QDPB$S 1 , FNC ,LUN ,EFN ,PRI , IOST ,AST , <PRMLST> ,ERR 
.ENDM QIO$S 



C.2.81 QIO$ Macro 

The QIO$ macro generates the QUEUE I/O DPB. 

Macro call: QIO$ FNC, LUN, EFN, PRI , IOST, AST, PRMLST 

Description: This macro generates the required DPB specified for the 
QUEUE I/O directive. The arguments are treated as follows: 

FNC-I/O Function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Priority, 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 

PRMLST-Parameter list of the form <P1,...,P6> 

All of the arguments must be valid expressions to be used in assembler 
data storage directives. The first call of this macro defines the 
following symbols and assigns, as a value, their byte offset from the 
beginning of the DPB: 



Q.IOFN- (length 2 bytes) I/O function, 

Q.IOLU-(2) Logical unit number, 

Q.IOEF-(l) Event flag number, 

Q.IOPR-(l) Priority, 

Q.IOSB-(2) Address of I/O status block, 

Q.IOAE-(2) Address of I/O done AST entry point, 

Q.IOPL-(O) Parameter list (up to 6 words). 



If the $$$GLB symbol is defined, QIO$ does not generate the DPB and it 
globally defines the symbolic offsets. 

Note: The argument PRI is required to maintain compatibility with 
RSX-11D. Desite the fact that it must be specified, the QIO$ macro 
ignores it. 

.MACRO QIO$ FNC, LUN, EFN, PRI, IOST, AST, PRMLST 
.MCALL QDPB$ 

QDPB$ 1, FNC, LUN, EFN, PRI, IOST, AST, <PRMLST> 
.ENDM QIO$ 



C.2,82 QIOW$C Macro 

The QIOW$C macro generates a QUEUE I/O AND WAIT DPB in a separate 
PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: QIOW$C FNC, LUN, EFN, PRI , IOST, AST, PRMLST, PSECT, ERR 

Description: This macro generates the required QUEUE I/O AND WAIT DPB 
in the program section named $DPB$$. All of the arguments through 
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PRMLST are as described for the QIOW$ macro. The argument PSECT 
should be the name of the original program program section into which 
the standard monitor trap code is generated. The optional argument, 
ERR, is the error routine address. 

Note: Read the note concerning ignored arguments in the QIOW$ macro 
below. 

.MACRO QIOW$C FNC,LUN,EFN,PRI ,IOST, AST, PRMLST, PSCT, ERR 
.MCALL QDPB$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

QDPB$ 3,FNC,LUN,EFN,PRI , IOST ,AST , <PRMLST> 
.IFT 

.PSECT PSCT 
DIR$ #$$-$, ERR 
.ENDC 
•ENDM QIOW$C 



C.2.83 QIOW$S Macro 

The QIOW$S macro generates the code to push a queue I/O and wait DPB 
on the stack and generate an EMT 377. 

Macro call; QIOW$S FNC,LUN ,EFN,PRI , IOST, AST, PRMLST, ERR QIOW$S Macro 

Description: This macro generates the code to push the required QUEUE 
I/O AND WAIT DPB on the stack. The arguments through PRMLST represent 
the information as described in the QIOW$ macro. However, the 
arguments must all be valid assembler source operands. 

Note: Read the note concerning ignored arguments in the QIOW$ macro 
below. 

.MACRO QI0W$S FNC,LUN,EFN,PRI, IOST, AST, PRMLST, ERR 
.MCALL QDPB$S 

QDPB$S 3,FNC,LUN,EFN,PRI , IOST , AST , <PRMLST> , ERR 
.ENDM QIOW$S 



C.2.84 QIOW$ Macro 

The QIOW$ macro generates the QUEUE I/O AND WAIT DPB, 

Macro call: QIOW$ FNC,LUN,EFN,PRI , IOST, AST, PRMLST 

Description: This macro generates the required DPB specified for the 
QUEUE I/O AND WAIT directive. The arguments are treated as follows: 

FNC-I/O function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Prior ity , 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 

PRMLST-Parameter list of the form <P1,...,P6> . 

All of the arguments must be valid expressions to be used in assembler 
data storage directives. The first call of this macro defines the 
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following symbols and assigns, as values, their byte offset from the 
beginning of the DPB: 

Q.IOFN- (Length 2 bytes) I/O function, 

Q.IOLU-(2) Logical unit number, 

Q.IOEF-(l) Event flag number, 

Q.IOPR-(l) Priority, 

Q.I0SB-(2) Address of I/O status block, 

Q.I0AE-(2) Address of I/O done AST entry point, 

Q.IOPL-(O) Parameter list (up to 6 words). 

If the $$$GLB symbol is defined, QIOW$ does not generate the DPB and 
it globally defines the symbolic offsets. 

Note: This macro requires the PRI argument to maintain compatibility 
with RSX-11D. Despite the fact that it must be specified, QIOW$ 
ignores it. 

.MACRO QIOW$ FNC,LUN,EFN,PRI,IOST,AST,PRMLST 
.MCALL QDPB$ 

QDPB$ 3,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
.ENDM QIOW$ 



C.2.85 R50$ Macro 

This internal macro generates a two-word RADIX-50 name. 

Macro call: R50$ NAME 

Description: This macro converts the NAME argument into RADIX-50 
using the .RAD50 assembler directive. Furthermore, R50$ ensures that 
the data generated is at least two words long. 

.MACRO R50$ NAME 

.NLIST 

.NCHR $$$T1,NAME 

.LIST 

.IF EQ $$$T1 

.WORD 0,0 
IFF 

•IF GT $$$Tl-6 
$$$T4=.+4 

.IFTF 

.RAD 50 /NAME/ 

.IFT 
•»$$$T4 

.ENDC 

.IIF LT $$$Tl-4, .WORD 

.ENDC 

•ENDM R50$ 



C.2.86 RCVD$C Macro 

RCVD$C generates a DPB for the RECEIVE DATA directive in a separate 
PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: RCVD$C TASK, BUFADR,PSCT, ERR 

Description: RCVD$C generates a DPB for the RECEIVE DATA directive in 
the $DPB$$ program section. RCVD$ describes the DPB parameters. 
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RCVD$C then generates an EMT 377 in the program section named in PSCT. 
DIR$ describes the ERR error service address. RCVD$ controls the 
generation of symbolic offsets. 

•MACRO RCVD$C TN ,BA,CS ,ERR 
.MCALL RCVD$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

RCVD$ TN,BA 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
• ENDC 
.ENDM RCVD$C 



C.2.87 RCVD$S Macro 

The RCVD$S macro generates the code to push a DPB for the RECEIVE DATA 
directive on the stack followed by an EMT 377. 

Macro call: RCVD$S TSKNAMADR,BUFADR,ERR 

Description: This macro generates the code to push a DPB for the 
RECEIVE DATA directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RCVD$ macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIR$ macro. 

.MACRO RCVD5S TN,BA,ERR 

.MCALL MOV$,DIR$, RFA$ 

MOV$ BA 

RFA$ TN 

MOV (PC)+,-(SP) 

•BYTE 75., 4 

DIR$ ,ERR 

.ENDM RCVD$S 



C.2.88 RCVD$ Macro 

The RCVD$ macro generates a DPB for the RECEIVE DATA directive. 

Macro call: RCVD$ TASK,BUFADR 

Description: This macro generates a DPB for the RECEIVE DATA 
directive. The arguments are assumed to have the following meanings: 

TASK=Sender task name, 

BUFADR=Address of fifteen word buffer. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

R.VDTN- (length 4 bytes) Task name, 
R.VDBA-(2) Buffer address. 

If RCVD$ is invoked with the $$$GLB symbol defined, RCVD$ does not 
generate the DPB and it globally defines the symbolic offsets. 
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.MACRO RCVD$ TN,BA 

.MCALL OFF$, R50$ 

.IF NDF $$$GLB 

•BYTE 75., 4 

R50$ TN 

.WORD BA 

.ENDC 

.IF NDF R.VDTN 

.NLIST 

.IRP X,<,<R.VDTN,4>,<R.VDBA,2>> 

OFF$ X 

.ENDM 

• LIST 

.ENDC 

•ENDM RCVD$ 



C.2.89 RCVX$C Macro 



The RCVX$C macro generates a DPB for the RECEIVE DATA OR EXIT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: RCVX$C TASK, BUFADR,PSCT, ERR 

Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
DIRECTIVE in the program section named $DPB$$. The RCVX$ macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The ERR error service address is 
described in the DIR$ macro. The RCVX$ macro controls the generation 
of symbolic offsets. 

.MACRO RCVX$C TN,BA,CS,ERR 
.MCALL RCVX$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

RCVX$ TN,BA 
• IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM RCVX$C 



C.2.90 RCVX$S Macro 

The RCVX$S macro generates the code to push a DPB for the RECEIVE DATA 
OR EXIT directive on the stack followed by an EMT 377. 

Macro call: RCVX$S TSKNAMADR,BUFADR,ERR 

Description: This macro generates the code to push a DPB for the 
RECEIVE DATA OR EXIT directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the RCVX$ macro. This macro also generates 
an EMT 377 using the ERR error service address as defined in the DIR$ 
macro. 

.MACRO RCVX$S TN,BA,ERR 
.MCALL MOV$,DIR$, RFA$ 
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MOV$ BA 

RFA$ TN 

MOV (PC)+,-(SP) 

.BYTE 77., 4 

DIR$ ,ERR 

.ENDM RCVX$S 



C.2.91 RCVX$ Macro 

The RCVX$ macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. 

Macro call: RCVX$ TASK,BUFADR 

Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. The arguments are assumed to have the following meanings: 

TASK=Sender task name, 

BUFADR=Address of fifteen word buffer. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

R.VXTN- (length 4 bytes) Task name, 
R.VXBA-(2) Buffer address. 

If RCVX$ is invoked with the $$$GLB symbol defined, RCVX$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO RCVX$ TN,BA 

.MCALL OFF$, R50$ 

.IF NDF $$$GLB 

.BYTE 77., 4 

R50$ TN 

.WORD BA 

.ENDC 

.IF NDF R.VXTN 

.NLIST 

.IRP X,<,<R.VXTN,4>,<R.VXBA,2>> 

OFF$ X 

.ENDM 

.LIST 

. ENDC 

.ENDM RCVX$ 



C.2.92 RDAF$C Macro 

The RDAF$C macro generates a DPB for the READ ALL FLAGS directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: RDAF$C BUFADR,PSCT,ERR 

Description: This macro generates a DPB for the READ ALL FLAGS 
directive in the program section named $DPB$$. The DPB parameters are 
described in the RDAF$ macro. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIR$ macro describes the ERR 
error service address. The RDAF$ macro controls symbolic address 
generation. 
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•MACRO RDAF$C BA,CS,ERR 
.MCALL RDAF$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
RDAF$ BA 
• IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM RDAF$C 



C.2.93 RDAF$S Macro 



The RDAF$S macro generates the code to push a DPB for the READ ALL 
FLAGS directive on the stack followed by an EMT 377. 

Macro call: RDAF$S BUFADR,ERR 

Description: This macro generates the code to push a DPB for the READ 
ALL FLAGS directive on the stack. The DPB arguments must be valid 
assembler source operands and must specify the information described 
in the RDAF$ macro. RDAF$S also generates an EMT 377, using the ERR 
error service address, as described in the DIR$ macro. 

.MACRO RDAF$S BA,ERR 

.MCALL MOV$ ,DIR$ 

MOV$ BA 

MOV (PC)+,-(SP) 

.BYTE 39., 2 

DIR$ ,ERR 

.ENDM RDAF$S 



C.2.94 RDAFS Macro 

The RDAF$ macro generates a DPB for the READ ALL FLAGS directive. 

Macro call: RDAF$ BUFADR 

Description: This macro generates a DPB for the READ ALL FLAGS 
directive. The argument is assumed to have the following meaning: 

BUFADR=Address of four word buffer. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

R.DABA- (length 2 bytes) Buffer address. 

If the macro is invoked with the $$$GLB symbol defined, RDAF$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO RDAF$ BA 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 39., 2 

.WORD BA 

.ENDC 

.IF NDF R.DABA 
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.NLIST 

OFF$ 

OFF? R.DABA,2. 

.LIST 

.ENDC 

.ENDM RDAF$ 



C.2.95 RFA$ Macro 

RFA$ is an internal macro that pushes two words on the stack in 
reverse order from the specified double-word. 

Macro call: RFA$ ADR 

Description: RFA$ generates the code to push two words on the stack 
in reverse order from the double word with its address specified by 
the source operand's ADR. 

.MACRO RFA$ ADR 

•IF NB <ADR> 

.NLIST 

.NTYPE $$$T2,ADR 

.LIST 

.IF LT $$$T2-6 

MOV 2 (ADR) ,-(SP) 

MOV (ADR) ,-(SP) 

.IFF 

MOV ADR,-(SP) 

MOV @(SP) ,-(SP) 

ADD #2,2 (SP) 

MOV @2(SP) ,2(SP) 

.ENDC 

.IFF 

CLR ~(SP) 

CLR -(SP) 

.ENDC 

.ENDM RFA$ 



C.2.96 RQST$C Macro 

The RQST$C macro generates a DPB for the REQUEST directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: RQST$C TASK , PART, PRI ,UICGC,UICPC,PSCT, ERR 

Description: This macro generates a DPB for the REQUEST directive in 
the $DPB$$ program section. The RQST$ macro describes the DPB 
parameters. RQST$C then generates an EMT 377 in the program section 
named in PSCT. The DIR$ macro describes the ERR error service 
address. The RQST$ macro controls symbolic address generation. 

Note: Read the notice concerning ignored arguments in the RQST$ macro 
below. 

.MACRO RQST$C TN ,PN ,PR,GC ,P ,CS ,ERR 
•MCALL RQST$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
• IFTF 
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RQST$ TN,PN,PR,GC,P 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM 



C.2.97 RQST$S Macro 



The RQST$S macro generates the code to push a DPB for the REQUEST 
directive on the stack followed by an EMT 377. 

Macro call: RQST$S TSKNAMADR,PRTNAMADR,PRI ,UICGC,UICPC,ERR 

Description: RQST$S generates the code to push a DPB for the REQUEST 
directive on the stack. The DPB arguments must be valid assembler 
source operands and must specify the information described in the 
RQST$ macro. RQST$S also generates an EMT 377 using the ERR error 
service address described in DIR$. 

Note: Read the notice concerning ignored arguments in the RQST$ macro 
below. 

.MACRO RQST$S TN ,PN ,PR,GC ,P ,ERR 

.MCALL MVB$,RFA$,DIR$ 

MVB$ P,GC 

CLR -(SP) 

RFA$ 

RFA$ TN 

MOV (PC)+,-(SP) 

.BYTE 11., 7 

DIR$ ,ERR 

.ENDM RQST$S 



C.2.98 RQST$ Macro 

The RQST$ macro generates a DPB for the REQUEST directive. 

Macro call: RQST$ TASK, PART, PRI ,UIGC ,UICPC 

Description: This macro generates a DPB for the REQUEST directive. 
The arguments are assumed to have the following meanings: 

TASK*Task name, 
PART=Partition name, 
PRI=Priority, 
UICGC=UIC group code, 
UICPC-UIC programmer code. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

R.QSTN- (length 4 bytes) Task name, 
R.QSPN-U) Partition name, 
R.QSPR-(2) Priority, 
R.QSGC-(l) UIC Group, 
R.QSPC-(l) UIC Programmer. 
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If RQST$ is invoked with the $$$GLB symbol defined, RQST$ does not 
generate the DPB and it globally defines the symbolic offsets. 

Note: RQST$ requires the arguments PART and PRI to maintain 
compatibility with RSX-llD. Despite the fact that they must be 
specified, RQST$ ignores them. 

.MACRO RQST$ TN ,PN ,PR,GC ,P 
.MCALL R50$,OFF$ 
.IF NDF $$$GLB 

• BYTE 11. ,7 
R50$ TN 
.WORD 0,0 
.WORD 
.BYTE P,GC 
.ENDC 

.IF NDF R.QSTN 
•NLIST 

• IRP X,<,<R.QSTN,4>,<R.QSPN,4>,<R.QSPR,2>,<R.QSPC,1>,<R.QSGC,1>> 
OFF$ X 

.ENDM 

• LIST 
.ENDC 
.ENDM RQST$ 



C.2.99 RSUM$C Macro 

The RSUM$C macro generates a DPB for the RESUME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: RSUM?C TASK, PSCT, ERR 

Description: This macro generates a DPB for the RESUME directive in 
the $DPB$$ program section. The RSUM$ macro describes the DPB 
parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The ERR error service address is described in 
the DIR$ macro. The RSUM$ macro controls generation of symbolic 
offsets. 

.MACRO RSUM$C TN,CS,ERR 
.MCALL RSUM$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

.IFTF 

RSUM$ TN 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

•ENDM RSUM$C 



C.2.100 RSUM$S Macro 

The RSUM$S macro generates the code to push a DPB for the RESUME 
directive on the stack and the code for an EMT 377. 

Macro call: RSUM$S TSKNAMADR,ERR 
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Descriptions This macro generates the code to push a DPB for the 
RESUME directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RSUM$ macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIR$ macro. 

.MACRO RSUM$S TN,ERR 

.MCALL RFA$ ,DIR$ 

RFA$ TN 

MOV (PC)+,-<SP) 

.BYTE 47., 3 

DIR$ ,ERR 

.ENDM RSUM$S 



C.2.101 RSOM$ Macro 

The RSUM$ macro generates a DPB for the RESUME directive. 

Macro call: RSUM$ TASK 

Description: This macro generates a DPB for the RESUME directive. 
The argument is assumed to have the following meaning: 

TASK=Task name. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

R.SUTN- (length 4 bytes) Task name. 

If RSUM$ is invoked with the $$$GLB symbol defined, RSUM$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO RSUM$ TN 

.MCALL R50$,OFF$ 

•IF NDF $$$GLB 

.BYTE 47. ,3 

R50$ TN 

.ENDC 

.IF NDF R.SUTN 

.NLIST 

OFF$ 

OFF$ R.SUTN, 4 

.LIST 

.ENDC 

.ENDM RSUM$ 



C.2.102 RUN$C Macro 

RUN$C generates a DPB for the RUN directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 

Macro call: RUN$C TSK ,PRT,PRI ,UGC,UPC,SMG,SNT,RMG,RNT,PSCT,ERR 

Description: RUN$C generates a DPB for the RUN directive in the 
$DPB$$ program section. RUN$ describes the DPB parameters. RUN$C 
then generates an EMT 377 in the program section named in PSCT. DIR$ 
describes the ERR error service address. The RUN$ macro controls 
symbolic address generation. 
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Notes Read the discussion notice concerning ignored arguments in the 
RUN$ macro below. 

.MACRO RUN$C TN ,PN ,PR f UG ,UP,SM,SU ,RM,RU ,CS ,ERR 
.MCALL RUNS,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

.IFTF 

RUN$ TN,PN,PR,UG,UP,SM,SU,RM,RU 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM RUN$C 



C.2.103 RDN$S Macro 

RUN$S generates the code to push a DPB for the RUN directive on the 
stack and generates an EMT 377. 

Macro call: RUN$S TNAMADR,PNAMADR,PRI ,UGC,UPC,SMG,SNT,RMG,RNT,ERR 

Description: RUN$S generates the code to push a DPB for the RUN 
directive on the stack and generates an EMT 377 using the ERR error 
service address described in DIRS. DPB arguments must be valid 
assembler source operands and must specify the information described 
in the RUN$ macro. 

Note: Read the discussion notice concerning ignored arguments in the 
RUN$ macro below. 

.MACRO RUN$S TN ,PN ,PR,UG ,UP ,SM,SU ,RM,RU ,ERR 

.MCALL RVP$,MVB$,RFA$,DIR$ 

RVP$ SM,SU,RM,RU 

MVB$ UP,UG 

CLR -(SP) 

RFA$ 

RFA$ TN 

MOV (PC)+,-(SP) 

•BYTE 17., 11. 

DIR$ ,ERR 

.ENDM RUNSS 



C.2.104 RDN$ Macro 

The RUN$ macro generates a DPB for the RUN directive. 

Macro call: RUN$ TSK,PRT,PRI ,UGC,UPC,SMG,SNT,RMG,RNT 

Description: The arguments must have the following meanings: 

TSK=Task name, 
PRT=Partition name, 
PRI=Priority, 
UGC-UIC group code, 
UPC=UIC programmer code, 
SMG=Schedule delta magnitude, 
SNT=Schedule delta unit, 
RMG=Re-schedule interval magnitude, 
RNT a Re-schedule interval unit. 
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The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

R.UNTN- (length 4 bytes) Task name, 

R.UNPN-(4) Partition name, 

R.UNPR-(2) Priority, 

R.UNGC-(l) UIC group, 

R.UNPC-(l) UIC programmer, 

R.UNSM-(2) Schedule magnitude, 

R.UNSU-(2) Schedule unit, 

R.UNRM-(2) Re-schedule magnitude, 

R.UNRU-(2) Re-schedule unit. 

If RUN$ is invoked with the $$$GLB symbol defined, RUN$ does not 
generate the DPB and RUN$ globally defines the symbolic offsets. 

Note: RUN$ requires the PRT and PRI arguments to maintain 
compatibility with RSX-llD. Despite the fact that they must be 
specified, RUN$ ignores them. 

.MACRO RUN? TN,PN,PR,GC,P,SM,SU,RM,RU 

.MCALL R50$,OFF$ 

.IF NDF $$$GLB 

• BYTE 17 . ,11. 

R50$ TN 

.WORD 0,0 

.WORD 

.BYTE P,GC 

.WORD SM 

.WORD SU 

.WORD RM 

.WORD RU 

.ENDC 

.IF NDF R.UNTN 

.NLIST 

•IRP X,<,<R.UNTN,4>,<R.UNPN,4>,<R,UNPR,2>,<R.UNPC,1>,<R.UNGC,1>> 

OFF$ X 

.ENDM 

•IRP X,<<R.UNSM,2>,<R.UNSU,2>,<R.UNRM,2>,<R.UNRU,2>> 

OFF$ X 

.ENDM 
.LIST 
.ENDC 
.ENDM RUN$ 



C.2.105 RVP$ Macro 

RVP$ is an internal macro that places the parameters passed as an 
argument list into the stack in reverse order. 

Macro call: RVP$ Al ,A2 , . . . ,A10 

Description: RVP$ pushes the elements of the argument list on the 
stack in reverse order. RVP$ assumes all elements to be full-word. 
The list is limited to a maximum of ten elements. 

.MACRO RVP$ P0,P1,P2,P3,P4,P5,P6,P7,P8,P9 

.MCALL MOV$ 

.NLIST 

•NARG $$$ARG 

.LIST 
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.IIP GT $$$ARG-9. r MOV$ <P9> 
•IIP GT $$$ARG-8., MOV$ <P8> 
.IIF GT $$$ARG-7, MOV$ <P7> 
.IIP GT $$$ARG-6, MOV$ <P6> 
.IIF GT $$$ARG-5, MOV$ <P5> 
■IIF GT $$$ARG-4, MOV$ <P4> 
.IIF GT $$$ARG-3, MOV$ <P3> 
.IIF GT $$$ARG-2, MOV$ <P2> 
.IIP GT $$$ARG-1, MOV$ <P1> 
,IIF GT $$$ARG f MOV$ <P0> 
.ENDM RVP$ 



C.2.106 SDAT$C Macro 



The SDAT$C macro generates a DPB for the SEND DATA directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: SDAT$C TASK ,BUFADR,EFN ,PSCT, ERR 

Description: SDAT$C generates a DPB for the SEND DATA directive in 
the $DPB$$ program section and generates an EMT 377 in the program 
section named in PSCT. SDAT$ describes the DPB parameters and 
controls symbolic address generation. DIR$ describes the ERR error 
service address. 

.MACRO SDAT$C TN ,BA,EFN ,CS ,ERR 
.MCALL SDAT$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

SDAT$ TN,BA,EFN 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM SDAT$C 



C.2.107 SDAT$S Macro 

SDAT$S generates the code to push a DPB for the SEND DATA directive on 
the stack and generates an EMT 377. 

Macro call: SDAT$S TSKNAMADR,BUFADR,EFN,ERR 

Description: SDAT$S generates the code to push a DPB for the SEND 
DATA directive on the stack and generates an EMT 377 using the ERR 
error service address described in DIRS. The DPB arguments must be 
valid assembler source operands and they must specify the information 
described in the SDAT$ macro. 

•MACRO SDAT5S TN ,BA,EFN ,ERR 

.MCALL MOV$,RFA$,DIR$ 

MOV$ EFN 

MOV$ BA 

RFA$ TN 

MOV <PC)+,-(SP) 

.BYTE 71., 5 

DIR$ ,ERR 

.ENDM SDAT$S 
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C.2.108 SDAT$ Macro 

The SDAT$ macro generates a DPB for the SEND DATA directive. 

Macro call: SDAT$ TASK ,BUFADR, EFN 

Description: This macro generates a DPB for the SEND DATA directive. 
The arguments are assumed to have the following meanings: 

TASK=Receiver task name, 

BUFADR=Address of thirteen word data buffer, 

EFN=Event flag number. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

S.DATN- {length 4 bytes) Task name, 
S.DABA-(2) Buffer address, 
S.DAEF-(2) Event flag number. 

If SDAT$ is invoked with the $$$GLB symbol defined, SDAT$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO SDAT$ TN,BA,EFN 

.MCALL R50$,OFF$ 

.IF NDF $$$GLB 

.BYTE 71., 5 

R50$ TN 

.WORD BA 

•WORD EFN 

.ENDC 

.IF NDF S.DATN 

.NLIST 

.IRP X,<,<S.DATN,4>,<S.DABA,2>,<S.DAEF,2>> 

OFF$ X 
.ENDM 
• LIST 
.ENDC 
.ENDM SDAT$ 



C.2.109 SETF$C Macro 

The SETF$C macro generates a DPB for the SET EVENT FLAG directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 

Macro call: SETF$C EFN,PSCT,ERR 

Description: This macro generates a DPB for the SET EVENT FLAG 
directive in the program section named $DPB$$. The SETF$ macro 
describes the DPB parameters. The SETF$C macro then generates an EMT 
377 in the program section named in PSCT. The DIR$ macro describes 
the ERR error service address. The SETF$ macro controls symbolic 
offset generation. 

.MACRO SETF$C EFN, CS, ERR 
.MCALL SETF$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
SETF$ EFN 
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.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM SETF$C 



C.2.110 SETF$S Macro 

SETF$S pushes a DPB for the SET EVENT FLAG directive on the stack and 
generates an EMT 377. 

Macro call: SETF$S EFN,ERR 

Description: SET$F pushes a DPB for the SET EVENT FLAG directive on 
the stack. DPB arguments must be valid assembler operands and specify 
the information described in the SETF$ macro. SET$F also generates an 
EMT 377 using the ERR error service address that DIR$ describes. 

.MACRO SETF$S EFN,ERR 

.MCALL MOV$,DIR$ 

MOV$ EFN 

MOV (PC)+,-(SP) 

• BYTE 33., 2 

DIR$ ,ERR 

.ENDM SETF$S 



C.2.111 SETF$ Macro 

The SETF$ macro generates a DPB for the SET EVENT FLAG directive. 

Macro call: SETF$ EFN 

Description: This macro generates a DPB for the SET EVENT FLAG 
directive. The argument is assumed to have the following meaning: 

EFN=Event flag number. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

S.ETEF- (length 2 bytes) Event flag. 

If SETF$ is invoked with the $$$GLB symbol defined, SETF$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO SETF$ EFN 

.MCALL OFF$ 

•IF NDF $$$GLB 

.BYTE 33., 2 

.WORD EFN 

• ENDC 

.IF NDF S.ETEF 

.NLIST 

OFF$ 

OFF$ S.ETEF, 2 

.LIST 

.ENDC 

.ENDM SETF$ 
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C.2.112 SFPA$C Macro 

The SFPA$C macro generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in a separate PSECT followed by an EMT 377 in 
the user specified PSECT. 

Macro call: SFPA$C AST,PSCT,ERR 

Description: SFPA$C generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in the $DPB$$ program section. SFPA$ 
describes the DPB parameters. SFPA$C then generates an EMT 377 in the 
program section named in PSCT. DIR$ describes the ERR error service 
address. The SFPA$ macro controls symbolic offset generation. 

.MACRO SFPA$C AST, CS, ERR 
•MCALL SFPA$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$«. 
.IFTF 
SFPA$ AST 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
• ENDC 
.ENDM SFPA$C 



C.2.113 SFPA$S Macro 

SFPA$S generates the code to push a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive on the stack and generates an EMT 377. 

Macro call: SFPA$S AST, ERR 

Description: This macro generates the code to push a DPB for the 
SPECIFY FLOATING POINT EXCEPTION AST directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SFPA$ macro. The SFPA5S 
macro also generates an EMT 377 using the ERR error service address as 
described in the DIR$ macro. 

.MACRO SFPA$S AST, ERR 

.MCALL MOV$,DIR$ 

MOV? AST 

MOV (PC)+,-(SP) 

.BYTE 111., 2 

DIR$ ,ERR 

.ENDM SFPA$S 



C.2.114 SFPA$ Macro 

SFPA$ generates a DPB for the SPECIFY FLOATING POINT EXCEPTION AST 
directive. 

Macro call: SFPA$ AST 

Description: The argument must have the following meaning: 

AST^AST Service entry address. 
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The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 

S.FPAE- (length 2 bytes) AST Entry address. 

If SFPA$ is invoked with the $$$GLB symbol defined, SFPA$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO SFPA$ AST 

•MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 111. ,2 

.WORD AST 

• ENDC 

•IF NDF S.FPAE 

.NLIST 

OFF$ 

OFF$ S.FPAE, 2 

.LIST 

.ENDC 

.ENDM SFPA$ 



C.2.115 SPND$C Macro 

SPND$C generates a DPB for the SUSPEND directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 

Macro call: SPND$C PSCT,ERR 

Description: SPND$C generates a DPB for the SUSPEND directive in the 
$DPB$$ program section followed by an EMT 377 in the original program 
section named PSCT. DIR$ describes the ERR error service address. 

.MACRO SPND$C PSCT,ERR 
•MCALL SPND$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$=. 



.IFTF 

SPND$ 

.IFT 

•PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

.ENDM SPND$C 



C.2.116 SPND$S Macro 



The SPND$S macro generates the code to push a DPB for the SUSPEND 
directive on the stack and generates an EMT 377. 

Macro call: SPND$S ERR 

Description: This macro generates the code to push a one-word DPB for 
the SUSPEND directive on the stack. Then it generates an EMT 377 
using the error service address as described in the DIR$ macro. 

.MACRO SPND$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
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•BYTE 45., 1 
DIRS ,ERR 
.ENDM SPND$S 



C.2.117 SPND$ Macro 

The SPND$ macro generates a DPB for the SUSPEND directive. 

Macro call: SPND$ 

Description: This macro generates a DPB for the SUSPEND directive. 
There are no arguments. 

.MACRO SPND$ 
•IF NDF $$$GLB 
.BYTE 45., 1 
• ENDC 
.ENDM SPND$ 

C.2.118 SPRA$C Macro 

The SPAR$C macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive in a separate PSECT followed, by an EMT 377 in the user 
specified PSECT. 

Macro call: SPRA$C AST,PSCT,ERR 

Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive in the $DPB$$ program section. The SPRA$ macro 
describes the DPB parameters. The SPRA$C macro then generates an EMT 
377 in the program section named in PSCT. The DIR$ macro describes 
the ERR error service address. The SPRA? macro controls the 
generation of symbolic offsets. 

.MACRO SPRA$C AST, CS, ERR 
.MCALL SPRA$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
SPRA$ AST 
.IFT 

•PSECT CS 
DIRS #$$$,ERR 
.ENDC 
.ENDM SPRA$C 



C.2.119 SPRA$S Macro 

The SPRA$S macro generates the code to push a DPB for the SPECIFY 
POWER RECOVERY AST directive on the stack and generates an EMT 377. 

Macro call: SPRA$S AST, ERR 

Description: This macro generates the code to push a DPB for the 
SPECIFY POWER RECOVERY AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SPRA$ macro. The SPRA$S macro also 
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generates an EHT 377 using the ERR error service address as described 
in the DIR$ macro. 

.MACRO SPRA$S AST, ERR 

.MCALL MOV$,DIR$ 

MOV$ AST 

MOV (PC)+,-(SP) 

.BYTE 109., 2 

DIR$ ,ERR 

.ENDM SPRA$S 



C.2.120 SPRA$ Macro 

The SPRA$ macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive. 

Macro call: SPRA$ AST 

Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive. The argument is assumed to have the following 
meaning: 

AST^AST Service entry address. 

The following symbol is locally defined with is assigned a value equal 
to the byte offset from the start of the DPB to the DPB element: 

S.PRAE- (length 2 bytes) AST entry address. 

If SPRA$ is invoked with the $$$GLB symbol defined, SPRA$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO SPRA$ AST 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 109., 2 

.WORD AST 

.ENDC 

.IF NDF S.PRAE 

.NLIST 

OFF$ 

OFF? S.PRAE, 2 

.LIST 

.ENDC 

.ENDM SPRA$ 



C.2.121 SRDA$C Macro 

The SRDA$C macro generates a DPB for the SPECIFY RECEIVE DATA AST 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: SRDA$C AST,PSCT,ERR 

Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive in the $DPB$$ program section. The SRDA$ macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIR$ macro describes the ERR 
error service address. The SRDA$ macro controls symbolic offset 
generation. 
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.MACRO SRDA$C AST, CS, ERR 
.MCALL SRDA$,DIR$ 
.IF NDF $$$GLB 
•PSECT $DPB$$ 
$$$=. 
.IFTF 
SRDA$ AST 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM SRDA$C 



C.2.122 SRDA$S Macro 



SRDA$S macro pushes a DPB for the SPECIFY RECEIVE DATA AST directive 
on the stack and generates an EMT 377. 

Macro call: SRDA$S AST, ERR 

Description: This macro generates the code to push a DPB for the 
SPECIFY RECEIVE DATA AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SRDA$ macro. The SRDA$S macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIR$ macro. 

.MACRO SRDA$S AST, ERR 

.MCALL MOV$,DIR$ 

MOV$ AST 

MOV (PC)+,-(SP) 

.BYTE 107., 2 

DIR$ ,ERR 

.ENDM SRDA$S 



C.2.123 SRDA$ Macro 

SRDA$ generates a DPB for the SPECIFY RECEIVE DATA AST directive. 

Macro call: SRDA$ AST 

Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive. The argument is assumed to have the following meaning: 

AST=AST service entry address. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

S.RDAE- (length 2 bytes) AST entry address. 

If SRDA$ is invoked with the $$$GLB symbol defined, SRDA$ does not 
generate the DPB and it globally defines the symbolic offset. 

.MACRO SRDA$ AST 
.MCALL OFF$ 
.IF NDF $$$GLB 
•BYTE 107., 2 
•WORD AST 
.ENDC 
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•IF NDF S.RDAE 

.NLIST 

OFF$ 

OFF$ S.RDAE, 2 

.LIST 

.ENDC 

.ENDM SRDA$ 



C.2.124 SVDB$C Macro 



SVDB$C generates a DPB for the SPECIFY SST VECTOR TABLE FOR DEBUGGING 
AID directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: SVDB$C ADR,LEN ,PSCT,ERR 

Description: SVDB$C generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR DEBUGGING AID directive in the $DPB$$ program section and 
generates an EMT 377 in the program section named in PSCT. SVDB$ 
describes the DPB parameters and controls symbolic address generation. 
DIR$ describes the ERR error service address. 

.MACRO SVDB$C AD,LN,CS,ERR 
.MCALL SVDB$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
SVDB$ AD,LN 

• IFT 

.PSECT CS 
DIR$ #$$$,ERR 

• ENDC 

.ENDM SVDB$C 



C.2.125 SVDB$S Macro 

The SVDB$S macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR DEBUGGING AID directive on the stack and generates an 
EMT 377. 

Macro call: SVDB$S ADR,LEN,ERR 

Description: SRDA5S macro pushes a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive on the stack. DPB arguments must be 
valid assembler operands and must specify the information described by 
SVDB$ . SVDB$S also generates an EMT 377 using the ERR error service 
address described by DIR$. 

.MACRO SVDB$S AD,LN,ERR 

•MCALL MOV$,DIR$ 

MOV$ LN 

MOV$ AD 

MOV (PC)+,-(SP) 

.BYTE 103., 3 

DIR$ ,ERR 

.ENDM SVDB$S 
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C.2.126 SVDB$ Macro 



The SVDB5 macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
DEBUGGING AID directive. 

Macro call: SVDB$ ADR,LEN 

Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive. The arguments are assumed to have 
the following meanings: 

ADR=Address of SST vector table, 
LEN=Length of {number of entries in) table. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

S.VDTA- (length 2 bytes) Table address, 
S.VDTL-(2) Table length. 

If SVDB$ is invoked with the $$$GLB symbol defined, SVDB$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO SVDB$ A,L 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 103., 3 

.WORD A 

.WORD L 

.ENDC 

.IF NDF S.VDTA 

.NLIST 

.IRP X,<,<S.VDTA,2>,<S.VDTL,2>> 

OFF$ X 
.ENDM 
.LIST 
.ENDC 
.ENDM SVDB$ 



C.2.127 SVTK$C Macro 

SVTK$C generates a DPB for the SPECIFY SST VECTOR TABLE FOR TASK 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: SVTK$C ADR,LEN ,PSCT,ERR 

Description: SVTK$C generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR TASK directive in the $DPB$$ program section and generates an EMT 
377 in the program section named in PSCT. DIR$ describes the ERR 
error service address. The SVTK$ macro controls symbolic address 
generation and describes DPB parameters. 

.MACRO SVTK$C ADR,LEN ,CS ,ERR 
•MCALL SVTK$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

SVTK$ ADR,LEN 
.IFT 
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.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM SVTK$C 



C.2.128 SVTK$S Macro 

The SVTK$S macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR TASK directive on the stack and generates an EMT 377. 

Macro call: SVTK$S ADR,LEM,ERR 

Description: This macro generates the code to push a DPB for the 
SPECIFY SST VECTOR TABLE FOR TASK directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SVTK$ macro. This macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIR$ macro. 

.MACRO SVTK$S ADR,LEN,ERR 

.MCALL MOV$,DIR$ 

MOV$ LEN 

MOV$ ADR 

MOV (PC)+,-(SP) 

.BYTE 105., 3 

DIR$ ,ERR 

.ENDM SVTK$S 



C.2.129 SVTK$ Macro 

The SVTK$ macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
TASK directive. 

Macro call: SVTK$ ADR, LEN 

Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR TASK directive. The arguments are assumed to have the 
following meanings: 

ADR=Address of SST vector table, 
LEN=Length of (number of entries in) table. 

The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

S.VTTA- (length 2 bytes) Table address, 
S.VTTL-(2) Table length. 

If SVTK$ is invoked with the $$$GLB symbol defined, SVTK$ does not 
generate the DPB and it globally defines the symbolic offsets. 

.MACRO SVTK? TA,TL 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 105., 3 

.WORD TA 

.WORD TL 

.ENDC 

.IF NDF S.VTTA 
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.NLIST 

.IRP X,<,<S.VTTA,2>,<S.VTTL,2>> 

OFF$ X 
.ENDM 
.LIST 
.ENDC 
.ENDM SVTK$ 



C.2.130 WSIG$C Macro 

The WSIG$C macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: WSIG5C PSCT, ERR 

Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive in the $DPB$$ program section followed by an EMT 377 
in the user specified program section that is named PSCT. The DIR$ 
macro describes the ERR error service address. 

.MACRO WSIG$C PSCT, ERR 
.MCALL WSIG$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$ = 



• IFTF 

WSIG$ 

.IFT 

.PSECT PSCT 

DIR$ #$$$,ERR 

.ENDC 

•ENDM WSIG$C 



C.2.131 WSIG$S Macro 



The WSIG$S macro generates the code to push a DPB for the WAIT FOR 
SIGNIFICANT event directive on the stack and generates an EMT 377. 

Macro call: WSIG$S ERR 

Description: This macro generates the code to push a one-word DPB for 

the WAIT FOR SIGNIFICANT EVENT directive on the stack. Then it 

generates an EMT 377 using the ERR error service address as described 
in the DIR$ macro. 

•MACRO WSIG$S ERR 
.MCALL DIR$ 
MOV (PC)+,-(SP) 
.BYTE 49. ,1 
DIR$ ,ERR 
.ENDM WSIG$S 



C.2.132 WSIG$ Macro 

The WSIG$ macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive. 
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Macro call: WSIG$ 

Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive. There are no arguments. 

.MACRO WSIG$ 
.IF NDF $$$GLB 
.BYTE 49. ,1 
.ENDC 
.ENDM WSIG$ 



C.2.133 WTLO$C Macro 

The WTLO$C Macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: WTLO$C SET, MASK ,PSCT, ERR 

Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive in the $DPB$$ program section. The WTLO$ 
macro describes the DPB parameters. The WTLO$C macro then generates 
an EMT 377 in the program section named in PSCT. The DIR$ macro 
describes the ERR error service address. The WTLO$ macro controls 
symbolic offset generation. 

Note: Read the discussion notice concerning ignored arguments in the 
WTLO$ macro below. 

•MACRO WTLO$C SET,MASK ,CS ,ERR 
.MCALL WTLO$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$=. 



.IFTF 

WTLO$ SET,<MASK> 

• IFT 

•PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM WTLO$C 



C.2.134 WTLO$S Macro 



The WTLO$S macro generates the code to push a DPB for the WAIT FOR 
LOGICAL OR OF EVENT FLAGS directive on the stack and generates an EMT 
377. 

Macro call: WTLO$S SET, MASK, ERR 

Description: This macro generates the code to push a DPB for the WAIT 
FOR LOGICAL OR OF EVENT FLAGS directive on the stack. The arguments 
are assumed to have the following meanings: 

SET=Desired set of event flags (0-4) 

MASK=Assembler source operand that yields the desired 
mask word 

The macro also generates an EMT 377, using the ERR error service 
address as described in the DIR$ macro. 
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Note: Read the discussion notice concerning ignored arguments in the 
WTLO$ macro below. 

.MACRO WTLO$S SET,MSK,ERR 

.MCALL MOV$,DIR$ 

.IF EQ SET-4 

.ERROR SET ^unsupported macro option; 

.IFF 

MOV$ MSK 
.IF NE SET 
MOV #SET,-(SP) 
.IFF 
LR -(SP) 
. ENDC 

MOV (PC)+,-(SP) 
.BYTE 43., 3 
.ENDC 
DIR$ ,ERR 
.ENDM WTLO$S 



C.2.135 WTLO$ Macro 

The WTLO$ macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive. 

Macro call: WTLO$ SET, MASK 

Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive. The arguments are assumed to have the 
following meanings: 

SET=Desired set of event flags (0-4) , 

MASK-If set is 0, 1, 2, or 3, a 16-bit (16 flag mask word; 
If set is 4, a list of four mask words (<Ml ,M2 ,M3 ,M4>) . 

WTLO$ does not define any symbolic offsets. WTLO$ does not generate 
any code if the $$GLB symbol is defined at the time WTLO$ is invoked. 

Note- RSX-11M does not support the specification of flags set number 
4. If flag set number 4 is specified it causes an error. 

•MACRO WTLO$ SET, MASK 

.IF NDF $$$GLB 

.IF EQ SET-4 

.ERROR SET ; Unsupported macro option 

.'iff 

.BYTE 43., 3 
.WORD SET 
.WORD MASK 
.ENDC 
• ENDC 

.ENDM WTLO$ 



C.2.136 WTSE$C Macro 

The WTSE$C macro generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 

Macro call: WTSE$C EFN,PSCT,ERR 
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Description: This macro generates a DPB for the WAIT FOR SINGLE EVENT 
FLAG directive in the $DPB$$ section. The WTSE$ macro describes the 
DPB parameters. The WTSE$C macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The WTSE$ macro controls symbolic address 
generation. 

.MACRO WTSE$C EF,CS,ERR 
.MCALL WTSE$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$*. 
• IFTF 
WTSE$ EF 
.IFT 

•PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM WTSE$C 



C.2.137 WTSE$S Macro 

The WTSE$S macro generates the code to push a DPB for the WAIT FOR 
SINGLE EVENT FLAG directive on the stack and generates an EMT 377. 

Macro call: WTSE$S EFN,ERR 

Description: This macro generates the code to push a DPB for the WAIT 
FOR SINGLE EVENT FLAG directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the WTSE$S macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIR$ macro. 

.MACRO WTSESS EF,ERR 

.MCALL MOV$,DIR$ 

MOV$ EF 

MOV (PC)+,-(SP) 

• BYTE 41., 2 

DIR$ ,ERR 

.ENDM WTSE$S 



C.2.138 WTSE$ Macro 

WTSE$ generates a DPB for the WAIT FOR SINGLE EVENT FLAG directive. 

Macro call: WTSE$ EFN 

Description: WTSE$ generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive. The argument must have the following meaning: 

EFN=Event flag number. 

The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 

W.TSEF- (length 2 bytes) Event flag number. 

If WTSE$ is invoked with the $$$GLB symbol defined, WTSE$ does not 
generate the DPB and it globally defines the symbolic offset. 
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.MACRO WTSE$ EFN 

.MCALL OFF? 

.IF NDF $$$GLB 

.BYTE 41., 2 

.WORD EFN 

.ENDC 

.IF NDF W.TSEF 

.NLIST 

OFF$ 

OFF$ W.TSEF, 2 

.LIST 

.ENDC 

.ENDM WTSE$ 



C.3 EXECUTIVE MACRO EXPANSIONS 



The following coded instructions are expansions of macros that you may 
find in the Executive source listings of RSX-11M. 



C.3.1 CALL Macro 

.MACRO CALL SUBR ARG 

.IF IDN <$INTSV>,<SUBR> 

JSR R5,$INTSV 

.IF DF L$$SI1 

.WORD ARG 

. IFF 

".WORD "C<ARG>&PR7 

.ENDC 

.IFF 

.IF IDN <$SAVNR>,<SUBR> 

JSR R5,$SAVNR 

.IFF 

.IF IDN <$SWSTK>,<SUBR> 

EMT 376 

•WORD ARG 

• IFF 

JSR PC, SUBR 
.ENDC 
.ENDC 
.ENDC 

• ENDM 



C.3. 2 CALLR Macro 

CALLR is a call and return from subroutine macro. 

.MACRO CALLR SUBR 

JMP SUBR 

.ENDM 
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C.3.3 CRASH Macro 

CRASH crashes the system. 

.MACRO CRASH 

IOT 

.ENDM 

C.3.4 DIRSV$ Macro 

DIRSV$ is the directive register save and set priority macro. 

.MACRO DIRSV$ 
JSR R5,$DIRSV 
.ENDM 

C.3.5 DRSTS Macro 

DRSTS causes a trap to set directive status. 

.MACRO DRSTS VALUE 

TRAP VALUE 

.ENDM 



C.3.6 GTUCB$ Macro 

GTUCB$ generates code to load the UCB address into R5. It is called 
by INTSE$ and INTSV$ only. 

.MACRO GTUCB$ UCBSV,NCTRLR 

•IF NB <UCBSV> 

.IF GT NCTRLR-1 

MOV UCBSV(R4) ,R5 

.IFF 

MOV UCBSV,R5 

• ENDC 

.IFF 

•IF GT NCTRLR-1 

MOV CNTBL{R4) ,R5 

.IFF 

MOV CNTBL,R5 

.ENDC 

.ENDC 

.ENDM 



C.3.7 INTLB Macro 

Generates an interrupt routine entry point label, 

.IF DF E$$DVC 
.MACRO INTLB NUM,NAM 
$'NAM'NUM'T: : 
• ENDM 
.ENDC 
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C.3.8 INTSE$ Macro 

This is the interrupt save generation macro for error logging devices, 

.MACRO INTSE$ DEV, PRI , NCTRLR, PSWSV, UCBSV, ?LAB 

.IF DF L$$DRV & LD$'DEV & M$$MGE 
$'DEV'INT:! 

.IF NDF E$$DVC 

.IF EQ NCTRLR-1 

CLR R4 

.ENDC 

.ENDC 

.IFF 

•IF NDF E$$DVC 
$'DEV'INT::INTSV$ DEV,PRI ,NCTRLR,PSWSV,UCBSV 

.IF EQ NCTRLR-1 

CLR R4 

.ENDC 

.MEXIT 

.IFF 
$$$=0 

.REPT NCTRLR 

INTLB \$$$,DEV 

JSR R5,$INTSE 

SCBLB \$$$,DEV 

•IF DF L$$SI1 

.WORD PRI 

.IFF 

.WORD "C<PRI>&PR7 

.ENDC 

.IF GT NCTRLR-$$$-l 

BR LAB 

.ENDC 
$$$=$$$+1 

. ENDR 
LAB: 

.ENDC 

.ENDC 

GTUCB$ UCBSV, NCTRLR 

.ENDM 



C.3.9 INTSV$ Macro 

INTSV? causes interrupt save generation for non-error logging devices, 

.MACRO INTSV$ DEV , PRI , NCTRLR, PSWSV, UCBSV 

.IF NDF L$$DRV ! M$$MGE 1 LD$'DEV 

.IF GT NCTRLR-1 

.IF B <PSWSV> 

MFPS TEMP 

.IFF 

MFPS PSWSV 

.ENDC 

.IFTF 

JSR R5,$ INTSV 

.IF DF L$$SI1 

.WORD PRI 

. IFF 

!wORD A C<PRI>&PR7 

.ENDC 

.IFT 

.IF B <PSWSV> 
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MOV TEMP,R4 

.IFF 

MOV PSWSV,R4 

• ENDC 

BIC #177760, R4 

ASL R4 

.ENDC 

.ENDC 

GTUCB$ UCBSV,NCTRLR 

.ENDM 



C.3.10 MFPS/MTPS Macros 

These macros either read or write processor status. 

.IF NDF L$$SI1 

.MACRO MFPS DST 

MOVB @ IPS, DST 

• ENDM 

.MACRO MTPS SRC 

.IF IDN <#0>,<SRC> 

CLRB @#PS 

.IFF 

MOVB SRC,@#PS 

.ENDC 

.ENDM 

.ENDC 



C.3.11 RETURN Macro 

RETURN generates an RTS PC instruction. 

.MACRO RETURN 
RTS PC 
.ENDM 

C.3.12 SAVNR Macro 

SAVNR causes a jump to a subroutine to save nonvolatile registers. 

•MACRO SAVNR 
JSR R5,$ SAVNR 
.ENDM 

C.3.13 SCBLB Macro 

SCBLB generates a general status control block reference label. 

.IF DF E$$DVC 
.MACRO SCBLB NUM,NAM 
.WORD $'NAM'NUM 
.ENDM 
• ENDC 
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C.3.14 SETD Macro 

SETD sets the floating-point processor to double precision mode, 

.MACRO SETD 
.WORD 170011 
.ENDM 



C.3.15 SOB Macro 

SOB generates a decrement loop. 

•IF NOP R$$EIS 

.MACRO SOB A,B 

DEC A 

BNE B 

.ENDM 

• ENDC 



C.3.16 STD Macro 

STD stores a single or double proecision word from the floating-point 
processor. 

•MACRO STD A,B 

.NTYPE N,A 

.NTYPE M,B 

.WORD 174000+<N*64.>+M 

.ENDM 



C.3.17 STFPS Macro 

STFPS stores the floating-point processor's status. 

.MACRO STFPS A 
•NTYPE N,A 
.WORD 170200+N 
.ENDM 

C.3.18 STST Macro 

STST stores the floating-point exception code and exception address 
pointer. 

.MACRO STST A 

.WORD 170337 

.WORD FLSTS 

.ENDM 

.ENDC 

.IIF NDF S$$YDF, .LIST 
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C.3.19 SWSTK$ Macro 

SWSTK$ calls $SWSTK to switch system states. 

.MACRO SWSTK$ ARG 

CALL $SWSTK,ARG 

.ENDM 

.IF DF F$$LPP 

C.3.20 LDD Macro 

LDD loads double precision floating-point word into the accumulator, 

.MACRO LDD A,B 

.NTYPE N,A 

.NTYPE M,B 

.WORD 172400+<M*64.>+N 

.ENDM 

C.3.21 LDFPS Macro 

LSFPS loads floating-point status. 

.MACRO LDFPS A 

.IF IDN <A>,<@H.FPSA(R2) > 

.WORD 170100+72 

.WORD H.FPSA 

• IFF 

.NTYPE N,A 

•WORD 170100+N 

.ENDC 

.ENDM 

C.4 FILES-11 HEADER OFFSETS MACRO DEFINITIONS 



C.4.1 FHD01$ Macro 

FHD01$ defines Files-11 offsets. 

.MACRO FHDOIS OFFSET 
.MCALL DEF$I, OFFSET, DEFIN$ 
.IF DF,H.FPRO 
. ERROR 
• ENDC 

Header Area Offsets 



DEF$I 

OFFSET H.IDOF,l 
OFFSET H.MPOF,l 
OFFSET H.FNUM,2 
OFFSET H.FSEQ,2 
OFFSET H.FLEV,2 
OFFSET H.FOWN 
OFFSET H.PROG,! 



IDENT area offset in words 
Map area offset in words 
File number 
File sequence number 
Structure level and system number 
Owner of file consisting of: 
Programmer number 
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OFFSET H.PROJ,l 
OFFSET H.FPRO,2 

File Protection Bits 

DEFIN$ FP.RDV,1 
DEFIN$ FP.WRV,2 
DEFIN$ FP.EXT,4 
DEFIN$ FP.DEL,10 
DEFIN$ FP.RAT,1 
OFFSET H.FCHA 



Project number 

File protection code 



;Read access allowed if clear 
;Write access allowed if clear 
; Extend access allowed if clear 

jDelete allowed if clear 
;Read attributes allowed if clear 
;File characteristics code 

; consisting of: 
; User controlled characteristics byte 



OFFSET H.UCHA,1 
Bit Definitions for User Controlled Characteristics Byte 



DEFIN$ UC. CON, 200 
DEFIN$ UC.DLK,100 
OFFSET H.SCHA,! 



;File is logically contiguous if set 

;Deaccess lock set if bit is set 

;System controlled characteristics 
; byte 



Bit Definitions for System Controlled Characteristics Byte 



DEFIN$ SC.MDL,200 
DEFIN$ SC. BAD, 100 
OFFSET H.UFAT,32. 
OFFSET S.HDHD 

Ident Area Offsets 

DEF$I 
OFFSET I.FNAM,6 
OFFSET I.FTYP,2 
OFFSET I.FVER,2 
OFFSET I.RVNO,2 
OFFSET I.RVDT,7 
OFFSET I.RVTI,6 
OFFSET I.CRDT,7 
OFFSET I.CRTI,6 
OFFSET I.EXDT,7 
OFFSET ,1 
OFFSET S.IDHD 
DEFIN$ I.DAS2,7 
DEFIN$ I.TISZ,6 



;Marked for delete if set 
;Bad data block in file if set 
;User file attributes 
;Size in bytes of header area 



File name in RAD50 

File type in RAD50 

File version number in binary 

Revision number 

Revision date 

Revision time 

Creation date 

Creation time 

Expiration date 

Round up to word boundary 

Size in bytes of IDENT area 

Number of bytes in date string 

Number of bytes in time string 



C.4.2 FHDOF$ Macro 

FHDOF$ defines Files-11 header offsets. 



FHDOF$ 
FHDOF? DEF$L 
FHDOF$ DEF$G 
.MACRO FHDOF$ GLOBAL 
.MCALL FHD01$ 
. . ,GBL=0 
.IF B, GLOBAL 
FHD01$ DEF$L 
.IFF 

.IF IDN,<GLOBAL>,<DEF$G> 
...GBL=1 
.ENDC 
FHDOl? GLOBAL 



;Define offsets locally 
;Define offsets locally 
;Define offsets globally 
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.ENDC 




.IF DIF,<GLOBAL>,<DEF$N> 


•MACRO 


FHDOF$ ARG1 


.ENDM FHDOF? 


.ENDC 




.ENDM FHDOF$ 


ip Area 


Offset 


DEF$I C 


) 


OFFSET 


M.ESQN,1 


OFFSET 


M.ERVN,1 


OFFSET 


M.EFNU,2 


OFFSET 


M.EFSQ,2 


OFFSET 


M.CTSZ,1 


OFFSET 


M.LBSZ,1 


OFFSET 


M.USE,1 


OFFSET 


M . MAX , 1 


OFFSET 


M . RTRV 


OFFSET 


S.MPHD 



; Redefine macro 



! Extension sequence number 

[Extension relative volume number 

i Extension file number 

[Extension file sequence number 

;Block count field size 

[Logical block number field size 

[Words in use in the map 

[Max number of words available in map 

(Start of retrieval pointers 

;Size in bytes of the map area 



Checksum for File Header 



DEFIN$ H.CKSM,510. 

•IF DIF,<OFFSET>,<DEF$N> 

.MACRO FHD01$ ARG1 

.ENDM FHD01$ 

.ENDC 

.ENDM FHDOIS 



;Sum of words 0-255, 



C.4.3 HMBOF$ And HMB01$ Macros 

HMBOF$ and HMB01$ define Files-11 home block offsets. 



HMBOF$ 

HMBOF$ DEF$L 

HMBOF$ DEF$G 

.MACRO HMBOF$ GLOBAL 

.MCALL HMB01$ 

. . .GBL=0 

•IF B, GLOBAL 

HMB01$ DEF$L 

.IFF 

.IF IDN,<GLOBAL>,<DEF$G> 

. . .GBL=1 

.ENDC 

HMB01$ GLOBAL 

• ENDC 

.IF DIF,<GLOBAL>,<DEF$N> 

.MACRO HMBOF$ ARG1 

.ENDM HMBOF$ 

.ENDC 

.ENDM HMBOF$ 

.MACRO HMB01$ OFFSET 

.MCALL DEF$I, OFFSET, DEFIN$ 

DEF$I 



;Define offsets locally 
;Define offsets locally 
;Define offsets globally 



OFFSET H.IBSZ,2 
OFFSET H.IBLB,4 
OFFSET H.FMAX,2 
OFFSET H.SBCL,2 
OFFSET H.DVTY,2 
OFFSET H.VLEV,2 



;Index bit map size 

;Index bit map LBN 

;Maximum number of files on volume 

/•Storage bit map cluster factor 

;Disk device type 

;Structure level 
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OFFSET H.VNAM,12. 
OFFSET ,4 
OFFSET H.VOWN,2 
OFFSET H.VPRO,2 

OFFSET H.VCHA,2 



j Volume name - ASCII 
; RESERVED 

,• Volume owner's UIC 
;Volume protection code 

;Volume characteristics 



New Home Block Information Down to H.FIEX 



OFFSET H.DFPR,2 

.IF DF,H.FPRO 

. ERROR 

.ENDC 

.IF DF,R$$11M 

OFFSET H.VFSQ,2 



,2 
,4 



.IFF 
OFFSET 
.ENDC 
OFFSET 

OFFSET H.WISZ,1 
OFFSET H.FIEX, 1 
OFFSET H.LRUCl 
OFFSET ,11. 
OFFSET H.CHK1,2 
OFFSET H.VDAT,14. 
OFFSET ,398. 
OFFSET H.INDN,12, 
OFFSET H.INDO,12. 
OFFSET H.INDF,12. 
OFFSET ,2 
OFFSET H.CHK2,2 

.IF DIF,<OFFSET>,<DEF$N 

•MACRO HMB01$ ARG1 

.ENDM HMB01$ 

.ENDC 

.ENDM HMB01$ 

.IIF NDF,S$$YDF,.LIST 



;Default file protection 

;Tried to multiply define H.FPRO 



/Volume file sequence number 
{Updated by dismount 

;Not used 

;Not used 

;Window size for all files on volume 
;Default file extend in blocks 
;Number of entries in directory LRU 
/Available 

/Checksum of words 0-28. 
/Creation date 

/Reserved for relative volume table 
/System independent volume name 
/System independent owner name 
/System independent format type 
/Not used 

/Checksum of words 0-255. 
> 



C.5 FILE CONTROL SERVICES MACRO EXPANSIONS 



C.5.1 BDOFF$ Macro 

BDOFF$ generates the buffer descriptor offsets, 
occurs as for file descriptor offsets. 

.MACRO BDOFF5 OFFSET 
.MCALL OFFSET, DEF$I 
DEF$I 
OFFSET ,4 
OFFSET B.VBN,4 
OFFSET B.BBFS,2 

OFFSET B.NXBD,2 
OFFSET ,1 
OFFSET B.BFST,1 
OFFSET ,2 
OFFSET S.BFHD 

.IIF IDN,<DEF$N>,<OFFSET>, .MEXIT 
.MACRO BDOFF$ ARG 
.ENDM BDOFF$ 
ENDM BDOFF$ 



The same type of call 



/Virtual block number for this buffer 
/NUMBER OF bytes read or written 

/Pointer to next buffer descriptor 
/Spare byte 
/Buffer status byte 
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C.5.2 CBYTE$ Macro 

CBYTE$ conditionally assembles a .BYTE directive for VAR at the 
specified offset, from the beginning of the FDB. 

.MACRO CBYTES VAR,OFFSET 

.IF NB,VAR ;If non null 

. .PC2=. ;Save PC 

». . .PC1+0FFSET ?Set PC to specified offset 

BYTE VAR ; Assemble the byte 

». . .PC2 ; Restore PC 

ENDC 

ENDM CBYTE$ 



C.5.3 CLOSE$ Macro 

CLOSE$ closes a file. 

.MACRO CLOSE$ FDB, ERR 

•MCALL LDFDB$,ERR$ 

LDFDB$ FDB 

.GLOBL .CLOSE 

JSR PC, .CLOSE 

ERR$ ERR 

.ENDM CLOSES 



C.5.4 CMOV$2 Macro 

CMOV$2 conditionally moves two words from VAR to the specified offset 
of RO. 

.MACRO CMOVS2 VAR, OFFSET 

•IIF B,VAR,.MEXIT 

MOV VAR,-(SP) ;Address of 2 words to state 

MOV @(SP) , OFFSET (RO) ;First word to FDB 

ADD #2,(SP) ;Calculate address of 2nd word 

MOV @(SP)+,OFFSET+2(R0) ;2nd word to FDB 

.ENDM CMOV$2 



C.5.5 CMOV$B Macro 

CMOV$B conditionally generates a MOVE BYTE instruction to move a byte 
to the specified offset of RO . 

.MACRO CMOV$B VAR, OFFSET 

.IF IDN,<#0>,<VAR> 

CLRB OFFSET (RO) 

•MEXIT 

.ENDC 

.IIF NB,VAR, MOVB VAR, OFFSET (RO ) 

•ENDM CMOV$B 
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C.5.6 CMOV$W Macro 

CMOV$W conditionally moves a word to the specified offset of RO , 

.MACRO CMOV$W VAR, OFFSET 

.IF IDN,<#0>,<VAR> 

CLR OFFSET (RO) 

•MEXIT 

.ENDC 

.IIF NB,VAR, MOV VAR , OFFSET (RO) 

.ENDM CMOV$W 



C.5.7 CWORD$ Macro 

CWORD$ conditionally assembles a .WORD directive for VAR at the 
specified offset for the beginning of the FDB. 

MACRO CWORD$ VAR, OFFSET 

IF NB,VAR ;If VAR is not null 

. . PC2=. ;Save the PC 

=.. .PCl+OFFSET ;Set the PC to the specified offset 

WORD VAR ; Assemble the word 

=...PC2 ;Restore the PC 

ENDC 

ENDM CWORD$ 



C.5.8 DEF$G Macro 

DEF$G defines offsets globally. 

.MACRO DEF$G VAR,SIZ ;Define global offset 
.MCALL DEF$L 
.IIF NB,VAR, .GLOBL VAR 
DEF$L VAR, SI Z 
.ENDM DEF$G 



C.5.9 DEF$I Macro 

.MACRO DEF$I IVAL ; Initialize definition 
. . .TPC="0<IVAL> jMacros program counter 
.ENDM DEF$I 



C.5.10 DEF$L Macro 

.MACRO DEF$L SYM,SIZ 

.IF NB,SYM 

SYM=~0<. . .TPO 

.ENDC 

.IF NB,SIZ 

. ..TPC^CK. . .TPC+SIZ> 

.ENDC 

.ENDM DEF$L 
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C.5.11 DEF$N Macro 

DEF$N updates . . .TPC but does not define the symbol. 

•MACRO DEF$N VAR,SIZ ;Define no offset-calculate the size 
.MCALL DEF$L 
DEF$L ,SI2 
.ENDM DEF$N 



C.5.12 DEFIN$ Macro 

DEFIN$ equates the symbol with its specified value and defines it 
globally if ...GBL = 1. Otherwise, it locally defines the symbol. 

.MACRO DEFIN$ SYM,VAL 

.IIF EQ,. ,.GBL-l,.GLOBL SYM 

SYM="Q<VAL> 

.ENDM DEF1N$ 



C.5.13 DELET$ Macro 

DELET$ deletes a file. 

•MACRO DELET$ FDB,ERR 

.MCALL LDFDB$,ERR$ 

LDFDB5 FDB 

.GLOBL .DELET 

JSR PC,. DELET 

ERR$ ERR 

.ENDM DELET? 



C.5.14 FCSBT$ Macro 

FCSBT$ defines FCS bits and values locally or globally. Call with 
DEF$G for global definitions; conventionally called with DEF$L for 
local, but anything not equal to DEF$G will do 

MACRO FCSBT$ GLOBL 

MCALL DEFIN$ 

. .GBL=0 

IIF IDN,<GLOBL>,<DEF$G>,. . ,GBL=1 

F.RATT bits - Record Attribute Byte 

DEFIN? FD.FTN,1 ; FORTRAN carriage control bit 

DEFIN$ FD.CR,2 ; Insert carriage returns between 

■ r scord s 
DEFIN$ FD.PRN,4 |r.SEQ/VFC print file 

DEFIN$ FD.BLK,10 ;1 if records cannot cross block 

; boundaries 

F.RACC bits - Record Access Byte 

DEFIN? FD.RWM,1 ;On if read/write, off if GET/PUT 

DEFIN$ FD.RAN,2 ;0n if random, off if sequential 

DEFIN$ FD.PLC4 ;0n if partial locate, off if 

; sequential 
DEFIN$ FD.INS,10 ;0n if put sequential insert 

;mode; off if truncate mode 
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F.RCTL bits - Record Control Byte - Device Characteristics 



DEFIN? FD.REC1 

DEFIN$ .D.CCL,2 
device? 

DEFIN$ FD.TTY,4 
DEFIN$ FD.DIR,10 

DEFIN$ FD.SDI,20 
DEFIN$ FD.SQD,40 
DEFIN$ FD. ISP, 2000 
DEFIN$ FD.OSP,4000 
DEFIN$ FD.PSE, 10000 
DEFIN$ FD.COM, 20000 
DEFIN$ FD.F11, 40000 
DEFIN? FD.MNT, 100000 

N.STAT Bits - File Name Block Status Word - Set by parse 



;On if record oriented device, 

;off if block oriented 

;On if carriage control output 

;off if not 

;On if this device is a TTY 

;On if directory device, off if 

;not 

;On if single directory device 

;On if sequential device 

; Input spooling 

;Output spooling 



DEFIN$ NB.VER,1 
DEFIN$ NB.TYP,2 
DEFIN? NB.NAM,4 
DEFIN? NB.SVR,10 
DEFIN$ NB.STP,20 
DEFIN? NB.SNM,40 
DEFIN$ NB.DIR,100 

DEFIN$ NB.DEV,200 
DEFIN? NB.SD1,400 

PPN 
DEFIN? NB.SD2,1000 

PPN 



;Set if file version was explicit 

;Set if file type was explicit 

;Set if file name was explicit 

jSet if * in version field 

;Set if * in type field 

;Set if * in name field 

;Set' if explicit directory 

? ^^ecif ied 

;Set if device name was explicit 

;Set if * in project number of 

;Set if * in programmer number of 



***** NOTE: MORE BITS IN N.STAT ARE LOCALLY USED BY FCS 



Check Definition Section in FCS 
F.RTYP Values - Record Type Byte 
Note: These are values, not bits 

DEFIN? R.FIX,1 
DEFIN? R.VAR,2 
DEFIN? R.SEQ,3 

F.FACC Bits - File Access Byte 

DEFIN? FA.RD,1 

DEFIN? FA.WRT,2 

DEFIN? FA. EXT, 4 

DEFIN? FA.CRE,10 

DEFIN? FA.TMP,20 

DEFIN? FA.SHR,40 



; Fixed length records 
;Variable length records 
; Sequenced records 



;Set if read only 
;Set if accessed for write 
;Set if access for extend 
;Set if creating new file 
jSet if creating temp file 
;Set if shared access 



The following two names apply to the same control bit in F.FACC: 

FA.APD is only used if the file is an existing file 

FA.CRE=0); 

FA.NSP is only used if the file is being created 

(FA.CRE=1) 
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DEFIN$ FA.APD,100 ;Set if appending (POSIT to EOF) 

DEFIN? FA.NSP,100 ;Set if inhibiting supersede on 

;file creation 
DEFIN? FO.RD,FA.RD ;Open for read 

DEFIN$ F0.WRT,FA.WRT1FA.EXTIFA.CRE ;Open for write (create) 
DEFIN? F0.APD,FA.WRT!FA.EXT1FA.APD ;Open for append 
DEFIN? FO.MFY,FA.WRT ;Open for modify 
FO.UPD,FA.WRT!FA.EXT ;Open for update 

Bits in F.ACTL in the FDB - Several of these bits also have local 
definitions in FCSPRE.MAC; however, all definitions are mutually 
exclusive. 



DEFIN? FA. ENB, 100000 
DEFIN? FA.WCK,20000 
DEFIN$ FA. SEQ, 40000 
DEFIN$ FA.DLK,1000 
DEFIN$ FA.RWD,4000 
DEFIN$ FA. POS, 10000 



DEFIN$ FA.EXC,2000 
F.CHR Bits - ACP Global Volume Characteristics 

DEFIN? CH.AND,1 ;ANSI 'D' format 

F.MBFG Bits - Multiple Buffering Flag Word - 

DEFIN? FD.RAH r l 

DEFIN$ FD.WBH,2 

Note: More bits in F.MBFG used in FCS locally 
.CTRL Function Codes 



; Enable use of F.ACTL word 
;Enable write check 
; Enable sequential processing only 
; Enable no lock on abnormal close 
; Enable rewind control for magtape 
;File creation position control for 
; magtape 
;Exclusive use bit 



;Read ahead if set - this or write 

; behind 

;Write behind if set - not both 



DEFIN? FF.RWD,1 
DEFIN$ FF.POE,2 
DEFIN$ FF.NV,3 
DEFIN$ FF.SPC4 
DEFIN$ FF.CHR,5 
DEFIN$ FF.RWF,6 
•MACRO FCSBT? ARG 
.ENDM FCSBT$ 
.ENDM FCSBT$ 



; Rewind 

;Position to end of volume (set) 

;Next volume 

; Space 

;Get APC characteristics 

; ERS rewind file 



C.5.15 FCSMC$ Macro 

FCSMC? executes an MCALL for all the FCS macros. 

•MACRO FCSMC? 

•MCALL OPEN?R,OPEN?W,OPEN?M,OPEN?U,OPEN?A, CLOSE? 

.MCALL OPNS?R,OPNS?W,OPNS?M,OPNS?U,OPNS?A 

.MCALL READ? , WRITE? ,WAIT? ,GET? f PUT? ,DELET? ,FINIT? 

.MCALL FSRSZ?,FDBDF?,FDAT?A,FDRC?A,FDOP?A,FDBF?A,FDBK?A 

•MCALL FDAT?R,FDRC?R,FDOP?R,FDBF?R,FDBK?R,NMBLK? 

.MACRO FCSMC? 

.ENDM FCSMC? 

.ENDM FCSMC? 
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C.5.16 FDAT$A Macro 

FDAT$A initializes the file attribute section of the FDB at assembly 
time. 

.MACRO FDAT$A RTYP ,RATT,RSI Z ,CNTG ,ALOC 

.MCALL FDOFF$ ,CBYTE$ ,CWORD$ 

FDOFF$ DEF$L 

CBYTE? <RTYP>,F.RTYP 

CBYTE$ <RATT>,F.RATT 

CWORD$ <RSIZ>,F.RSIZ 

CWORD$ <CNTG>,F.CNTG 

CWORD$ <ALOO,F.ALOC 

.ENDM FDAT$A 



C.5.17 FDAT$R Macro 

FDAT$R initializes the file attribute section of the FDB at run time. 

.MACRO FDAT$R FDB, RTYP ,RATT , RSI Z ,CNTG ,ALOC 

.MCALL LDFDB$,CMOV$W,CMOV$B 

LDFDB$ FDB ;Load FDB address 

CMOV$B RTYP, F. RTYP 

CMOV$B RATT,F.RATT 

CMOV$W RSIZ,F.RSIZ 

CMOV$W CNTG,F.CNTG 

CMOV$W ALOC,F.ALOC 

.ENDM FDAT$R 



C.5.18 FDBDF$ Macro 

FDBDF? allocates space at assembly time for the FDB. 

.MACRO FDBDF$ 
■MCALL FDBSZ$ 
FDBSZ$ 
. ..PC1-- 
.BLKB S.FDB 
.ENDM FDBDF$ 

C.5.19 FDBF$A Macro 

FDBF$A intializes the buffer descriptor section of the FDB at assembly 

time. 

.MACRO FDBF$A EFN ,OVBS ,MBCT ,MBFG 
.MCALL FDOFF$,CBYTE$,CWORD$ 
FDOFF$ DEF$L 
CBYTE$ <EFN>,F.EFN 
CWORD$ <OVBS>,F.OVBS 
CBYTE$ <MBCT>,F.MBCT 
CBYTE$ <MBFG>,F.MBFG 
•ENDM FDBF$A 
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C.5.20 FDBF$R Macro 

FDBF$R initializes the block buffer section of the FDB at run time. 

.MACRO FDBF$R FDB,EFN ,OVBS ,MBCT,MBFG 
MCALL LDFDB$,CMOV$W,CMOV$B 
LDFDB$ FDB 

CMOV$B EFN,F.EFN ; Event flag to use 

CMOV$W OVBS,F.OVBS ;Size of block buffer 

CMOV$B MBCT,F.MBCT ;No. of buffers 

CMOV$B MBFG,F.MBFG ; Read ahead or write behind 

.ENDM FDBF$R 



C.5.21 FDBK$A Macro 

FDBK$A initializes the block access section of the FDB at assembly 
time. 

•MACRO FDBK$A BKAD ,BKSZ ,BKVB,BKEF ,BKST ,BKDN 

.MCALL FDOFF$,CBYTE$,CWORD$ 

FDOFF$ DEF$L 

CWORD$ <BKAD>,F.BKDS+2 

CWORD$ <BKSZ>,F.BKDS 

CWORD$ <BKVB>,F.BKVB+2 ;Store low order only 

CBYTE$ <BKEF>,F.BKEF 

CWORD$ <BKST>,F.BKST 

CWORD$ <BKDN>,F.BKDN 

.ENDM FDBK$A 



C.5.22 FDBK$R Macro 

FDBK$R initializes the block access section of the FDB at run time. 

.MACRO FDBK$R FDB, BKAD ,BKS2 ,BKVB,BKEF ,BKST ,BKDN 

•MCALL LDFDB$ ,CMOV$B,CMOV$W,CMOV$2 

LDFDB$ FDB 

CMOV$W BKAD,F.BKDS+2 ; Block address-memory buffer 

CMOV$W BKSZ,F.BKDS ;Size of transfer in bytes 

CMOV$2 BKVB,F.BKVB ;Address of 2 word virtual 

; Block number, move both words 
CMOV$B BKEF,F.BKEF ; Event flag 

CMOV$W BKST,F.BKST ;ADR OF I/O STATUS BLOCK 

CMOV$W BKDN,F.BKDN ; Address of I/O done AST 

•ENDM FDBK$R 



C.5.23 FDBSZ$ Macro 

FDBSZ$ defines the size of the FDB as a local symbol (S.FDB) . 

.MACRO FDBSZ$ jDefine S.FDB as size of FDB 

.IIF DF,S.FDB,.MEXIT 

.MCALL FDOFF$,DEF$L 

FDOFFS DEF$N ; Invoke offset definitions but do 

; not actually define Jie offset 

; names 
DEF$L S.FDB ;Now define S.FDB 

.ENDM FDBSZ? 
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C.5.24 FDOP$A Macro 

FDOP$A initializes the file open section of the FDB at assembly time. 

.MACRO FDOP$A LUN ,FNPT ,DFNB ,FACC , FACTRL 

.MCALL FDQFF$,CBYTE$,CWORD$ 

FDOFF$ DEF$L 

CBYTE$ <LUN>,F.LUN 

CWORD$ <FNPT>,F.DSPT 

CWORD$ <DFNB>,F.DFNB 

CBYTE$ <FACO,F.FACC 

CWORD$ <FACTRL>,F.ACTL 

.ENDM FDOP$A 



C.5.25 FDOP$R Macro 

FDOP$R initializes the file open section of the FDB at run time, 

.MACRO FDOP$R FDB, LUN ,FNPT,DFNB ,FACC , FACTRL 

.MCALL LDFDB$,CMOV$W,CMOV$B 

LDFDB$ FDB 

CMOV$B LUN, F. LUN 

CMOV$W FNPT,F.DSPT 

CMOV$W DFNB,F.DFNB 

CMOV$B FACC,F.FACC 

CMOV$W FACTRL, F.ACTL 

•ENDM FDOP$R 



C.5.26 FDRC$A Macro 

FDRC$A initializes the record access section of the FDB at assembly 
time. 

.MACRO FDRC$A RACC ,URBA,URBS 
.MCALL FDOFF$,CBYTE$,CWORD$ 
FDOFF$ DEF$L 
CBYTE$ <RACO,F.RACC 
CWORD$ <URBA>,F.URBD+2 
CWORD$ <URBS>,F.URBD 
.ENDM FDRC'$A 



C.5.27 FDRC$R Macro 

FDRC$R initializes the record access section of the FDB at run time 

.MACRO FDRC$R FDB , RACC ,URBA ,URBS 

.MCALL LDFDB$,CMOV$W,CMOV$B 

LDFDB$ FDB 

CMOV$B RACC, F. RACC 

C..-V$W URBA,F.URBD+2 

CMOV$W URBS,F.URBD 

.ENDM FDRC$R 
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C.5.28 FDOF$L Macro 

FDOF$L calls FDOFF$ to locally define offsets. 
only once. 

.MACRO FDOF$L 
.MCALL FDOFF$ 
FDOFF$ DEF$L 
.ENDM FDOF$L 



This action occurs 



C.5.29 FDOFF$ Macro 

FDOFF$ is the File Descriptor Block definition macro. It is called 
with one of the following macro names: DEF$L, DEF$G, or DEF$N . DEF$L 
defines local offsets, DEF$G defines total offsets, and DEF$N defines 
the size of the FDB. 

•MACRO FDOFF$ OFFSET 
•MCALL OFFSET, DEF$I,NBOFF$ 
NBOFF$ OFFSET 
DEF$I 

File Attribute Section 



;Initialize the definition macro 



OFFSET F.RTYP,1 
OFFSET F.RATT,1 
OFFSET F.RSIZ,2 
OFFSET F.HIBK,4 
OFFSET F.EFBK,4 
OFFSET F.FFBY,2 
OFFSET S.FATT 

Record Access Section 



.■Record type 

; Record attributes 

; Record size 

;Highest virtual block no. allocated 

;End of file block number 

; First free byte in last block 

;Size of file attribute section 



OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 



F.RACC1 

F . RCTL , 1 

F.BKDS 

F.URBD,4 

F.BKST 

F.NRBD,2 

F.BKDN 

,2 

F.OVBS 

F.NREC,2 

F.EOBB,2 

F.CNTG 

F.RCNM,2 

F.STBK 

,2 

F.ALOC,2 



File Open Section 



OFFSET F.LUN,1 
OFFSET F.FACC1 
OFFSET F.DSPT,2 
OFFSET F.DFNB,2 



.Record access 
Record control 

Block I/O - buffer descriptor 
User's record buffer descriptor 
Block I/O - I/O status block address 
Next record buffer descriptor 
Block I/O - I/O done AST address 
2nd word of NRBD 
Override block buffer size 
Next record address in block buffer 
End of block buffer 
Size in blocks of contiguous file 
Record number for random records 
Address to read in statistics block 
2nd word of RCNM 

Allocate this much space when need 
To extend, + = contig, - - not 



; Logical unit number 

;File access 

;File descriptor pointer 

;Default file name block address 
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Block Buffer Section 

OFFSET F.BKEF 

OFFSET F.EFN,1 

OFFSET F.BKP1,1 

OFFSET F.ERR,2 

OFFSET F.MBCT,1 
OFFSET F.MBC1,1 
OFFSET F.MBFG,1 
OFFSET F.BGBC,! 



OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 



F.VBSZ,2 

F.BBFS,2 

F . BKVB 

F.VBN,4 

F.BDB,2 

F.SPDV,2 

F.SPUN,1 

F.CHR,1 



OFFSET F.ACTL,2 
OFFSET F.SEQN,2 



Block I/O - event flag number 

Event flag used in QIO 

Bookkeeping bits 

1st byte error return code 

2nd byte for QIO error indicator 

Number of buffers to use (desired) 

Number of buffers in use 

Multiple buffering control flags 

Big buffer block count (size in 

blocks) 
Virtual block size in bytes 
Block buffer size 
Block I/O - virtual block number 
Virtual block number 
Block buffer descriptor block 
Spool device indicator 
Spool unit designator 
ACP volume characteristics summary 

byte 
Access control word 
Sequence number for sequenced files 



File Name Block Section 

OFFSET F.FNB,S.FNB ;Beginning of file name block 

.IIF IDN,<OFFSET>,<DEF$N>,.MEXIT 

.IF IDN,<OFFSET>,<DEF$G> 

.GLOBL F.FNAM,F.FTYP,F.FVER,F.DVNM,F.UNIT 

.ENDC 

F . FNAM-N . FNAM+F . FNB 
F . FTYP=N . FTYP+F . FNB 
F . FVER=N • FVER+F . FNB 
F . DVNM=N . DVNM+F . FNB 
F.UNIT=N.UNIT+F.FNB 
OFFSET S.FDB 
.MACRO FDOFF$ ARG 
.ENDM FDOFF$ 
.ENDM FDOFF$ 



;Size of FDB 



C.5.30 FDSOF$ Macro 

FDSOF$ defines offsets relative to the file descriptor pointer, 
F.DSPT. 

•MACRO FDSOF$ OFFSET 

.MCALL OFFSET, DEF$I,DEF$L 

DEF$I 

OFFSET N.DEVD,4 ;Device string descriptor 

OFFSET N.DIRD,4 ;Directory string descriptor 

OFFSET N.FNMD,4 ;File name string descriptor 

OFFSET S.FIDS 

.IF IDN,<DEF$N>,<OFFSET> 
DEF$L S.FIDS 

.MEXIT 

• ENDC 

.MACRO FDSOF? ARG 

.ENDM FDSOF$ 

.ENDM FDSOF$ 
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C.5.31 FINIT$ and FSRSZ$ Macros 

FINIT$ and FSRSZ$ initialize the file control services. 

.MACRO FINIT$ 

•GLOBL .FINIT 

JSR PC,. FINIT 

•ENDM FINIT$ 

•MACRO FSRSZ$ NFILES ,BFSPAC ,PSECT 

.MCALL BDOFF$ ,DEF$L 

.IF NDF,S.BFHD 

BDOFF$ DEF$N 

DEF$L S.BFHD 

.ENDC 

.GLOBL .FSRCB 

.PSECT $$FSRl,GBL,OVR,D 

.IF NB,<BFSPAC> 

.BLKB NFILES*S.BFHD+<BFSPAC> 

.IFF 

.BLKB NFILES*<S.BFHD+512.> 

.ENDC 

.PSECT PSECT 

.ENDM FSRSZ? 



C.5.32 FSROF$ Macro 

FSROF$ generates the file storage region offsets. 

•MACRO FSROF$ OFFSET 
.MCALL OFFSET,DEF$I,DEF$L 

Define the Offsets for $$FSR2 

DEF$I 

OFFSET ,4 ;List head for allocation 

OFFSET A.BFSR,2 ;First address in FSRl 

OFFSET A.EFSR,2 ;Last address in FSRl 

***** D0 N0T SEPARATE THE FOLLOWING 2 DEFINITIONS 
OFFSET A.OWUI ,2 jUIC of owner (from task header) 
OFFSET A.FIPR,2 ;Default file protection „ord 

***** D0 NOT SEPARATE THE PRECEEDING 2 DEFINITIONS 

***** D0 N0 T SEPARATE THE FOLLOWING 3 DEFINTIONS 
OFFSET A.DPB,24. ;QI/0 DPB and scratch area 

OFFSET A.IOST,4 ;Scratch I/O status block 

OFFSET A.DFDR,24. ;Default directory information 

***** D0 NOT SEPARATE THE PRECEEDING 3 DEFINITIONS 

OFFSET A.DFBC,2 ;Default buffer count (multiple 

/•buffering) 
OFFSET A.DFUI,2 ;Default UIC (task UIC) 

OFFSET S.FSR2 ;Size of file storage region 2 

DEF$L S.FSR2 

Define Offsets Relative to Beginning of the Default Directory Info 

DEF$I 
OFFSET ,14. 

OFFSET D.DFID,6 ;Default directory ID 

OFFSET D.DFDV,2 ;Device name for default 

;directory ID 
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OFFSET D.DFUN,2 ;Unit number for default 

;directory ID 
.IIF IDN,<DEF$N>,<OFFSET>, .MEXIT 
.MACRO FSROF$ ARG 
.ENDM FSROF$ 
•ENDM FSROF$ 



C.5.33 GET$ Macro 

GET$ gets a record from a file. 

.MACRO GET$ FDB, INADR,MAXCNT ,ERR 

.MCALL LDFDB$,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W INADR,F.URBD+2 ;User record buffer address 

CMOV$W MAXCNT,F.URBD ;User record buffer size 

•GLOBL .GET 

JSR PC,. GET 

ERR$ ERR 

.ENDM GET$ 



C.5.34 GET$R Macro 

GET$R gets a record in random mode. 

.MACRO GET$R FDB, INADR,MAXCNT,LRCNM,HRCNM,ERR 

.MCALL LDFDB$ ,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W INADR,F.URBD+2 ;User record buffer address 

CMOV$W MAXCNT,F.URBD ;User record buffer size 

CMOV$W LRCNM,F.RCNM+2 ; Low order record number 

CMOV$W HRCNM,F.RCNM ;High order record number 

.GLOBL .GET 

JSR PC, .GET 

ERR$ ERR 

.ENDM GET$R 



C.5.35 GET$S Macro 

GET$S gets a record in strictly sequential mode. 

.MACRO GET$S FDB, INADR,MAXCNT ,ERR 

.MCALL LDFDB$,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W INADR,F.URBD+2 jUser record buffer address 

CMOV$W MAXCNT,F.URBD ;User record buffer size 

.GLOBL .GETSQ 

JSR PC,. GETSQ 

ERR$ ERR 

.ENDM GET$S 



C.5.36 NBOF$L Macro 

NBOF$L calls NBOFF$ to define offsets as local symbols. This action 
occurs only once. 
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.MACRO NBOF$L 
.MCALL NBOFF$ 
NBOFF$ DEF$L 
.ENDM NBOF$L 

If the FDB parameter is null or RO , LDFDB$ does 
Otherwise, it does move the FDB to RO . 



not move FDB to RO . 



•MACRO LDFDB$ FDB 
.IIF B,FDB,.MEXIT 
.NTYPE PAR$$$,FDB 
.IIF EQ,PAR$$$,.MEXIT 
MOV FDB,R0 
.ENDM LDFDB$ 



;I.f null then exit 

;If RO then exit 

;Else generate the move 



C.5.37 NBOFF$ Macro 

NBOFF$ generates the file name block offsets. 



.MACRO NBOFF$ OFFSET 

•MCALL OFFSET, DEF$I,DEF$L 

DEF$I 

OFFSET S.FNAM 

OFFSET S.FTYP 

OFFSET S.FNTY 

OFFSET S.FNBW 

S.FNAM=6 

S.FTYP=2 

S . FNTY=<S . FNAM+S . FTYP>/2 

OFFSET N.FID,6 

OFFSET N.FNAM, S.FNAM 

OFFSET N.FTYP, S.FTYP 

OFFSET N.FVER,2 

OFFSET S.NFEN 

DEF$L S.NFEN 

OFFSET N.STAT, 2 

OFFSET N. NEXT, 2 

OFFSET N.DID,6 

OFFSET N.DVNM,2 

OFFSET N. UNIT, 2 

OFFSET S.FNB 

DEF$L S.FNB 

S.FNBW=S.FNB/2 

•IIF IDN,<DEF$N>,<OFFSET> 

•MACRO NBOFF$ ARG 

•ENDM NBOFF$ 

•ENDM NBOFF$ 



Define as global if parameter 

Is DEF$G 



Size of filename in bytes 
Size of file type in bytes 

;Size of filename + type in words 
File ID 
Filename 
Type 
Version 

Size of name file entry in bytes 
Force at least a local definition 
Status 

Temp cell for find next 
Directory ID 
Device name in ASCII 
Unit number 
Size of FNB in bytes 
Force local definition at least 
Size of FNB in words 

•MEXIT ;Don't redefine the macro 



C.5.38 NMBLK$ Macro 

NMBLK$ defines the file name block at assembly time. 

•MACRO NMBLK$ FNAME ,FTYPE »VERS ,DEVNAM, UNIT 

•MCALL RAD50$ ,CWORD$ ,NBOFF$ 

NBOFF$ DEF$L ;Define name block offsets locally 

•IIF NDF, . . .PCI,. . .PC1=0 

. . .PC3=. . .PCI ;Preserve ...PCI 

. ..PC1=. 

.= . . .PC1+N.FNAM 

RAD50$ < FNAME >,S.FNAM/2 
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.=...PCl+N.FTYP 

RAD50$ <FTYPE>,S.FTYP/2 

CWORD$ <VERS>,N.FVER 

.IF NB,DEVNAM 

.= . . .PC1+N.DVNM 

.WORD "DEVNAM 

.ENDC 

C..ORD$ <UNIT>,N.UNIT 

.=.. .PC1+S.FNB 

...PC1=...PC3 ; Restore ...PCI 

.ENDM NMBLK$ 



C.5.39 OPEN$ Macro 
OPEN$ opens a file. 

.MACRO OPEN$ FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 

.MCALL FDOP$R,FDRC$R,ERR$,CMOV$B 

FDOP$R FDB,LUN,FNPT,DFNB,FACC 

FDRC$R ,RACC,URBA,URBS 

•GLOBL .OPEN 

JSR PC, .OPEN 

ERR$ ERR 

.ENDM OPEN$ 



C.5.40 OPEN$A Macro 

OPEN$A opens a file for appending. 

.MACRO OPEN$A FDB,LUN ,FNPT ,RACC ,URBA,URBS ,ERR 
•MCALL OPEN$ 

OPEN$ FDB,#FO.APD,LUN,FNPT, ,RACC,URBA,URBS,ERR 
•ENDM OPEN$A 



C.5.41 OPEN$M Macro 

OPEN$M opens a file for modification. 

.MACRO OPEN$M FDB ,LUN ,FNPT ,RACC ,URBA ,URBS ,ERR 

.MCALL OPEN$ 

OPEN$ FDB,#FO.MFY,LUN,FNPT, ,RACC,URBA,URBS,ERR 

.ENDM OPEN$M 



C.5.42 OPEN$R Macro 

OPEN$R opens a file for reading. 

.MACRO OPEN$R, FDB ,LUN ,FNPT,RACC ,URBA ,URBS ,ERR 
.MCALL OPEN$ 

OPEN$ FDB,#FO.RD,LUN,FNPT, , RACC ,URBA ,URBS ,ERR 
.ENDM OPEN$R 
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C.5.43 OPENSU Macro 

OPEN$U opens a file for updating. 

.MACRO OPEN$U FDB, LUN ,FNPT ,RACC ,URBA ,URBS ,ERR 
•MCALL OPEN$ 

OPEN? FDB, IFO.UPD, LUN, FNPT,, RACC, URBA,URBS, ERR 
• ENDM OPEN$U 



C.5.44 OPEN$W Macro 

OPEN$W opens a file for writing. 

.MACRO OPEN$W FDB, LUN ,FNPT,RACC ,URBA,URBS ,ERR 
.MCALL OPEN$ 

OPEN$ FDB,#FO.WRT,LUN,FNPT, ,RACC ,URBA,URBS ,ERR 
.ENDM OPEN$W 



C.5.45 OPNS$A Macro 

OPNS$A opens a shared file for appending. 

.MACRO OPNS$A FDB, LUN ,FNPT,RACC ,URBA,URBS ,ERR 
•MCALL OPEN$ 

OPEN$ FDB,#FA.SHR!FO.APD,LUN,FNPT, ,RACC ,URBA,URBS ,ERR 
.ENDM OPNS$A 



C.5.46 OPNS$M Macro 

OPNS$M opens a shared file for modification. 

.MACRO OPNS$M FDB ,LUN ,FNPT,RACC ,URBA ,URBS ,ERR 
•MCALL OPEN$ 

OPEN$ FDB,#FA.SHRJFO.MFY,LUN,FNPT, , RACC ,URBA,URBS ,ERR 
•ENDM OPNS$M 



C.5.47 OPNS$R Macro 

OPNS$R opens a shared file for reading. 

.MACRO OPNS$R FDB, LUN ,FNPT, RACC ,URBA,URBS , ERR 
•MCALL OPEN$ 

OPEN$ FDB,#FA.SHR!FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OPNS$R 



C.5.48 OPNS$U Macro 

OPNS$U opens a shared file for updating. 

.MACRO OPNS$U FDB, LUN, FNPT, RACC, URBA,URBS, ERR 
•MCALL OPEN$ 

OPEN$ FDB , # FA . SHR ! FO . UPD , LUN , FNPT , , RACC , URBA , URBS , ERR 
.ENDM OPNS$U 
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C.5.49 OPNS$W Macro 

OPNS$W opens a shared file for writing. 

.MACRO OPNS$W FDB, LUN, FNPT, RACC, URBA, URBS, ERR 
.MCALL OPEN$ 

OPEN$ FDB, #FA,SHR!FO.WRT, LUN, FNPT, r RACC ,URBA ,URBS ,ERR 
.ENDM OPNS$W 

C.5.50 OPNT$D Macro 

Create, access, and mark for delete a new file not entered in a 
directory. It will be deleted when closed (deaccessed) and will be 
properly deleted if program should terminate abnormally. 

.MACRO OPNT$D FDB ,LUN ,FNPT, RACC ,URBA ,URBS , ERR 

.MCALL OPNT$W 

OFNT$W FDB, LUN,FNPT, RACC, URBA, URBS 

BCS .+6 

JSR PC, .MRKDL 

ERR$ ERR 

.ENDM OPNT$D 



C.5.51 OPNT$W Macro 

OPNT$W creates and accesses a new file and does enter it in a 

directory. The file may be closed and reopened by file ID. The file 

should be deleted before the program exits otherwise it remains in the 

index file with no directory entry. 

.MACRO OPNT$W FDB, LUN ,FNPT, RACC ,URBA,URBS , ERR 
.MCALL OPEN$ 

OPEN$ FDB , #FA . TMP ! FO . WRT , LUN , FNPT , , RACC , URBA , URBS , ERR 
.ENDM OPNT$W 



C.5.52 OFID$ Macro 

OFID$ opens a file by file ID. 

.MACRO OFID$ FDB, FACC , LUN, FNPT, DFNB, RACC, URBA, URBS, ERR 

.MCALL FDOP$R,FDRC$R,ERR$,CMOV$B 

FDOP$R FDB, LUN, FNPT, DFNB, FACC 

FDRC$R , RACC, URBA, URBS 

.GLOBL .OPFID 

JSR PC, .OPFID 

ERR$ ERR 

•ENDM OFID$ 



C.5.53 OFID$A Macro 

OFID$A opens a file by file ID for appending. 

.MACRO OFID$A FDB , LUN , FNPT, RACC , URBA , URBS , ERR 
.MCALL OFID$ 

OFID$ FDB, IFO.APD, LUN, FNPT, , RACC , URBA, URBS , ERR 
.ENDM OFID$A 
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C.5.54 OFID$M Macro 

OFID$M opens a file for modification by file ID. 

.MACRO OFID$M FDB ,LUN ,FNPT,RACC ,URBA,URBS ,ERR 
•MCALL OFID$ 

OFID$ FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OFID$M 

C.5.55 OFID$R Macro 

OFID$R opens a file for reading by file ID. 

.MACRO OFID$R FDB ,LUN ,FNPT ,RACC ,URBA,URBS ,ERR 
.MCALL OFID$ 

OFID$ FDB,#FO.RD,LUN,FNPT, ,RACC ,URBA,URBS ,ERR 
.ENDM OFID$R 



C.5.56 OFID$U Macro 

OFID$U opens a file for updating by file ID. 

•MACRO OFID$U FDB,LUN ,FNPT,RACC ,URBA,URBS ,ERR 
.MCALL OFID$ 

OFID$ FDB,#FO.UPD,LUN,FNPT, ,RACC,URBA,URBS,ERR 
.ENDM OFID$U 



C.5.57 OFID$W Macro 

OFID$W opens a file for writing by file ID. 

.MACRO OFID$W FDB ,LUN ,FNPT ,RACC , URBA,URBS ,ERR 
.MCALL OFID$ 

OFID$ FDB,#FO.WRT,LUN,FNPT, ,RACC ,URBA,URBS ,ERR 
•ENDM OFID$W 



C.5.58 OFNB$ Macro 

OFNB$ opens a file by file name block. 

.MACRO OFNB$ FDB, FACC ,LUN ,FNPT,DFNB ,RACC ,URBA,URBS ,ERR 

.MCALL FDOP$R,FDRC$R,ERR$,CMOV$B 

FDOP$R FDB, LUN,FNPT,DFNB, FACC 

FDRC$R ,RACC,URBA,URBS 

.GLOBL .OPFNB 

JSR PC,. OPFNB 

ERR$ ERR 

•ENDM OFNB$ 
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C.5.59 OFNB$A Macro 

OFNBSA opens a file by file name block for appending. 

•MACRO OFNB$A FDB,LUN ,FNPT,RACC , URBA, URBS ,ERR 

.MCALL OFNB$ 

OFNB$ FDB, IFO.APD, LUN, FNPT,, RACC, URBA, URBS, ERR 

.ENDM OFNB$A 

C.5.60 OFNB$M Macro 

OFNB$M opens a file by file name block for modification. 

.MACRO OFNB$M FDB,LUN ,FNPT,RACC ,URBA,URBS ,ERR 
.MCALL OFNB$ 

OFNB$ FDB , # FO . MFY. , LUN , FNPT , , RACC , URBA , URBS , ERR 
.ENDM OFNB$M 



C.5.61 OFNB$R Macro 

OFNB$R opens a file by file name block for reading. 

.MACRO OFNB$R FDB, LUN , FNPT, RACC , URBA ,URBS , ERR 

.MCALL OFNB$ 

OFNB$ FDB, #FO.RD, LUN, FNPT,, RACC, URBA, URBS, ERR 

.ENDM OFNB$R 



C.5.62 OFNB$U Macro 

OFNB$U opens a file by file name block for updating. 

.MACRO OFNB$U FDB, LUN , FNPT , RACC , URBA , URBS , ERR 
.MCALL OFNB$ 

OFNB$ FDB, IFO.UPD, LUN, FNPT,, RACC, URBA, URBS, ERR 
.ENDM OFNB$U 



C.5.63 OFNB$W Macro 

OFNB$W opens a file by file name block for writing. 

.MACRO OFNB$W FDB , LUN , FNPT, RACC , URBA , URBS , ERR 

.MCALL OFNB$ 

OFNB$ FDB, #FO.WRT, LUN, FNPT,, RACC, URBA, URBS, ERR 

.ENDM OFNB$W 



C.5.64 PUT$ Macro 

PUT$ puts a record in random or sequential mode. 

.MACRO PUT$ FDB,OUTADR,OUTCNT,ERR 

.MCALL LDFDB$ ,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W 0UTADR,F.NRBD+2 ;Next record buffer address 

CMOV$W OUTCNT,F.NRBD ;Next record buffer size 
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.GLOBL .PUT 
JSR PC,. PUT 
ERRS ERR 
.ENDM PUT$ 



C.5.65 PUT$R Macro 

PUT$R puts a record in random mode. 

.MACRO PUT$R FDB,OUTADR,OUTCNT,LRCNM,HRCNM,ERR 

.MCALL LDFDB$,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W OUTADR,F.NRBD+2 ;Next record buffer address 

CMOV$W OUTCNT,F.NRBD ;Next record buffer size 

CMOV$W LRCNM,F.RCNM+2 ;Low order record number 

CMOV$W HRCNM,F.RCNM ;High order record number 

.GLOBL .PUT 

JSR PC,. PUT 

ERR$ ERR 

.ENDM PUTSR 



C.5.66 PUT$S Macro 

PUT$S puts a record in strictly sequential mode. 

.MACRO PUT$S FDB,OUTADR,OUTCNT,ERR 

.MCALL LDFDB$,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W OUTADR,F.NRBD+2 ;Next record buffer address 

CMOV$W OUTCNT,F.NRBD ?Next record buffer size 

•GLOBL .PUTSQ 

JSR PC,. PUTSQ 

ERR$ ERR 

.ENDM PUT$S 



C.5.67 RAD50$ Macro 

•MACRO RAD50$ STRING ,MAXWRD 

•PC2= . 
.RAD50 /STRING/ 

.IF GT,<.-.. .PC2>-"0<2*MAXWRD> 

.ERROR ; String RAD50 - string too long, 

; truncated 
.="0<. . .PC2+<2*MAXWRD>> 
.MEXIT 

• ENDC 

.REPT ~0<MAXWRD-<<.-. . .PC2>/2>> 
.WORD 

• ENDR 
.ENDM RAD50? 



C-98 



MACRO EXPANSIONS 

C.5.68 READ$ Macro 

READ$ reads a virtual block. 

.MACRO READ$ FDB, BKAD ,BKSZ ,BKVB,BKEF ,BKST ,BKDN ,ERR 

.MCALL FDBK$R,ERR$ 

FDBK$R FDB, BKAD, BKSZ ,BKVB ,BKEF ,BKST,BKDN 

.GLOBL .READ 

JSR PC,. RE AD 

ERR$ ERR 

.ENDM READ$ 



C.5.69 TRDNC$ Macro 

TRUNC$ truncates a file. 

.MACRO TRUNC$ FDB, ERR 

.MCALL LDFDB$,ERR$ 

LDFDB$ FDB 

.GLOBL .TRUNC 

JSR PC,. TRUNC 

ERR$ ERR 

.ENDM TRUNC$ 



C.5.70 WAIT$ Macro 

WAIT$ waits for I/O completion after a READ$ or WRITE$ macro 
execution. 

.MACRO WAIT$ FDB,EFN,BKST,ERR 
.MCALL LDFDB$,CMOV$W,CMOV$B,ERR$ 
LDFDB$ FDB 

CMOV$B EFN,F.EFN 
CMOV$W BKST,F.BKST 
.GLOBL .WAIT 
JSR PC,. WAIT 
ERR$ ERR 
.ENDM WAIT$ 



C.5.71 WRITE$ Macro 

WRITE$ writes a virtual block. 

.MACRO WRITE$ FDB , BKAD , BKSZ ,BKVB ,BKEF ,BKST ,BKDN , ERR 

.MCALL FDBK$R,ERR$ 

FDBK$R FDB , BKAD , BKSZ , BKVB , BKEF , BKST , BKDN 

.GLOBL .WRITE 

JSR PC,. WRITE 

ERR$ ERR 

.ENDM WRITE$ 
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C.6 NETWORK SYMBOL DEFINITION MACRO 



C.6.1 COMDF? Macro 



Commom Symbol Module for M/D Networks Implementation 

•MACRO COMDF$ DEF 

•NLIST 

.IF IDN <DEF>,<DEF$G> 

.GLOBL B.OT,B.UN,B.RC,B.RN,B.RP,B.RU,B.NA,B.UA,B.MN,B.MX 

.GLOBL CT.IN,CT.CN,LB.N,LB.E 

.GLOBL NT. IN, NT. NS 

.GLOBL CR.UR,CR.NR,CR.MX 

.GLOBL CR.N0,CR.N1,CR.N2,CR.N3,CR.N4,CR.N5,CR.N6,CR.N9, 

CR.N10,CR.N11 
.GLOBL CR.N7,CR.N8 
.GLOBL CR.DI,CR.DT,CR.DA 
.GLOBL IA.ISM,IA.ABO,IA.DIS,IA.NFW 
.GLOBL CN.IN,CN.OU,CN.UT,CN.NT 
.GLOBL OB.TA,OB.FS,OB.SQ,OB.BO,OB.TC,OB.'RD,OB.RA,OB.ND, 

OB.DD,OB,BM 
.GLOBL OB.TH,OB.TB,OB.TI,OB.CR,OB.LP,OB.PR,OB.PP,OB.PL,OB.MT 
.GLOBL OB.DT,OB.CS,OB.CP,OB.FH,OB.MH,OB.FL 
• ENDC 

; Object type value 
;Object type unit number 
; Offset to remote connect # 
; Offset to remote process name [RAD50] 
?Offset to remote UIC [.WORD 

; GROUP, USER] 
;Offset to # of user arguements 
;Offset to first user arguement 

;Minimum si2e of buffer [0 arguements] 
;Maximum size of buffer [8. arguments] 

;Send this message at AST level [XMIT] 
;No status message required [RECV] 
;Connect reject [remote user 

; rejection] 
;Connect reject [remote NCS rejection] 
;Maximum reason 
; Reject by NCS 

;Too many connects to remote node 
;Too many connects to remote process 
;Process does not exist on this node 
;Object type does not exist on this 

; node 
/•Destination address in use 
;Node shutting down 



; Invalid task name 
/•Invalid qualifier 
;Bad destination parameter 
/•Disconnect initiate 
disconnect terminate [CONFIRM] 
;Disconnect abort 
;Loopback normal 
;Loopback echo mode 
;Connect initiate 
;Connect confirm 
/•Disconnect abort [partner terminated] 



B.OT = 





B.UN = 


1 


B.RC = 


B.OT+2 


B.RP * 


B.RN+4 


B.RU = 


B.RP+4 


B.NA = 


B.RU+4 


B.UA « 


B.NA+2 


B.MN = 


B.UA 


B.MX = 


B.MN+10 


NT. IN = 


10 


NT.NS = 


1 


CR.UR = 


2 


CR.NR = 


3 


CR.MX = 


6 


CR.NO = 





CR.N1 = 


1 


CR.N2 = 


2 


CR.N3 = 


3 


CR.N4 = 


4 


CR.N5 = 


5 


CR.N6 = 


6 


CR.N7 = 


7 


CR.N8 = 


8. 


CR.N9 « 


11 


CR.N10 


= 12 


CR.N11 


= 13 


CR.DI = 


4 


CR.DT ■ 


5 


CR.DA = 


6 


LB.N=0 




LB.E=2 




CT.IN = 





CT.CN = 


1 


I A. ABO 


= -5 
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IA.DIS = -7 
IA.NFW = 177673 



IA.ISM = 


■ 1 


CN.IN = 


1 


CN.OU = 


2 


CN.UT = 


4 


CN.NT = 


10 


OB.TA - 





OB.FS - 


1 


OB.SQ = 


2 


OB. BO = 


3 


OB.TC = 


4 


OB.RD = 


5 


OB.RA " 


6 


OB.ND = 


7 


OB.DD = 


10 


OB.BM - 


11 


;12-17 


RESERVED 


OB.TH » 


20 


OB.TB = 


21 


OB.TI = 


22 


OB.CR = 


23 


OB. LP = 


24 


OB. PR = 


25 


OB.PP = 


26 


OB. PL = 


27 


OB.MT = 


30 


OB.DT = 


31 


OB.CS = 


32 


OB.CP = 


33 


OB.FH = 


34 


OB.MH = 


35 


OB.FL = 


36 


.MACRO 


COMDF$ A 


.ENDM 




.LIST 




• ENDM 




.END 





Disconnect requested [partner did 

disc QI03 
Topology change — partner no longer 

reachable 
Interrupt semaphore from partner 
If set: inhibit incoming connections 
If set: inhibit outgoing connections 
If set: user tap 
If set: NCL tap 
Task 

File system [dap] 
Sequential devices [DAP] 
Boot task 

Terminal control task 
Remote directives 
Resource allocater 
Network directory service 
DDCMP link 
Boot message link 

Terminal handler 
Terminal : block mode 
Terminal : interactive 
Card reader 
Line printer 
PAPER TAPE READER 
Paper tape punch 
Plotter 
Magnetic tape 
DECTAPE 

Cassette 
Card punch 
Fixed head disk 
Moving head disk 
Floppy disk 



C.7 PROGRAM LOGICAL ADDRESS SPACE EXTENSION MACRO EXPANSIONS 

C.7.1 ATRG$, ATRG$C, and ATRG$S Macros 

These macros generate the code to attach a region. 

.MACRO ATRG$ RDB 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE 57., 2 
.WORD RDB 
.ENDC 

.IF NDF A.TRBA 
OFF$ 

OFF$ A.TRBA, 2 
.ENDC \ 
.ENDM ATRG$ 
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.MACRO ATRG$C RDB,CS,ERR 

.MCALL ATRG$,DIR$ 
.IP NDF $$$GLB 
.PSECT $DPB$$ 
$$$». 
.IFTF 
ATRG$ RDB 
.IFT 

.PSECT CS 
DIRS #$$$,ERR 
.ENDC 
.ENDM ATRG$C 

.MACRO ATRG$S RDB, ERR 

•MCALL DIR$,MOV$ 

MOV$ RDB 

MOV (PC)+,-(SP) 

•BYTE 57., 2 

DIR$ ,ERR 

.ENDM ATRG$S 



C.7.2 .BLX., .BLKB., and .BLKW. Macros 

These macros define the block offset symbol. The Program Logical 
Address Space definition macros use these macros. 

.MACRO .BLKB. NUM,SYM,GBL 

.IF NB <SYM> 

.IF IDN <DEF$G>,<GBL> 
SYM=-$$$ 

.IFF 
SYM=$$$ 

.ENDC 

.ENDC 
$$$»$$$+NUM 

.ENDM .BLKB. 

.MACRO .BLKW. NUM,SYM,GBL 

.IF NB <SYM> 

•IF IDN <DEF$G>,<GBL> 
SYM==$$$ 

. IFF 
SYM=$$$ 

.ENDC 

.ENDC 
$$$-$$$+<2*NUM> 

.ENDM .BLKW. 

.MACRO .BLK. 
$$$ = 

.ENDM .BLK. 



C.7.3 CRAW$, CRAW$C, CRAW$S Macro 

These macros generate the code to create an address window. 

.MACRO CRAW$ WDB 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE 117., 2 
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.WORD WDB 

.ENDC 

.IF NDF C.RABA 

OFF$ 

OFF$ C.RABA ,2 

.ENDC 

.ENDM CRAW$ 

.MACRO CRAW$C WDB, CS, ERR 
.MCALL CRAW$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$5 

.IFTF 

CRAW$ WDB 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

•ENDM CRAW$C 

.MACRO CRAWS S WDB, ERR 

.MCALL DIR$,MOV$ 

MOV$ WDB 

MOV (PC)+,-(SP) 

.BYTE 117., 2 

DIR$ ,ERR 

.ENDM CRAW$S 



C.7.4 CRRG$, CRRG$C, and CRRG$S Macros 

These macros generate the code to create a region, 

.MACRO CRRG$ RDB 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 55., 2 

.WORD RDB 

.ENDC 

.IF NDF C.RRBA 

OFF$ 

OFF? C.RRBA, 2 

.ENDC 

.ENDM CRRG$ 

.MACRO CRRG$C RDB, CS, ERR 
.MCALL CRRG$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

$$$-. 
.IFTF 
CRRG$ RDB 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
• ENDC 
.ENDM CRRG$C 

.MACRO CRRG$S RDB, ERR 
.MCALL DIR$,MOV$ 
MOV$ RDB 
MOV (PC)+,-(SP) 
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.BYTE 55. ,2 
DIR$ ,ERR 
.ENDM CRRG$S 



C.7.5 DTRG$, DTRG$C, and DTRG$S Macros 

These macros generate the code to detach a region. 

.MACRO DTRG$ RDB 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 59., 2 

•WORD RDB 

.ENDC 

.IF NDF D.TRBA 

OFF$ 

OFF$ D.TRBA, 2 

.ENDC 

•ENDM DTRG$ 

.MACRO DTRG$C RDB, CS, ERR 
.MCALL DTRG$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 
DTRG$ RDB 
• IFT 

•PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM DTRG$C 



.MACRO DTRG$S RDB, ERR 

.MCALL DIR$,MOV$ 

MOV§ RDB 

MOV (PC)+,-(SP) 

.BYTE 59., 2 

DIR$ ,ERR 

.ENDM DTRG$S 



C.7.6 ELAW$, ELAW$C, and ELAW$S Macros 

These macros generate the code to eliminate an address window. 

.MACRO ELAW$ WDB 

.MCALL OFF$ 

•IF NDF $$$GLB 

.BYTE 119. ,2 

.WORD WDB 

.ENDC 

•IF NDF E.LABA 

OFF$ 

OFF$ E.LABA, 2 

.ENDC 

.ENDM ELAW$ 

.MACRO ELAW$C WDB, CS, ERR 
.MCALL ELAW$,DIR$ 
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.IF NDF $$$GLB 
.PSECT $DPB$$ 

.IFTF 

ELAW$ WDB 

. IFT 

.PSECT CS 

DIR$ #$■$$, ERR 

.ENDC 

.ENDM ELAW$C 

.MACRO ELAW$S WDB, ERR 

.MCALL DIR$,M0V$ 

MOV$ WDB 

MOV (PC)+,-(SP) 

.BYTE 119., 2 

DIR$ ,ERR 

•ENDM ELAW$S 



C.7.7 GMCX$, GMCX$C, and GMCX$S Macros 

The macros generate the code to get the mapping context. 

.MACRO GMCX$ WVEC 
.MCALL OFF$ 
.IF NDF $$$GLB 
.BYTE 113. ,2 
.WORD WVEC 
.ENDC 

.IF NDF G.MCVA 
OFF$ 

OFF$ G.MCVA, 2 
.ENDC 

.ENDM GMCX$ 

.MACRO GMCX$C WVEC, CS, ERR 
.MCALL GMCX$,DIR$ 
•IF NDF $$$GLB 
.PSECT $DPB$$ 
$$$=. 
.IFTF 

GMCX$ WVEC 
.IFT 

.PSECT CS 
DIR$ #$$$,ERR 
• ENDC 

.ENDM GMCX$C 
.MACRO GMCX$S WVEC, ERR 
.MCALL DIR$,MOV$ 
MOV$ WVEC 
MOV (PC)+,-(SP) 
.BYTE 11 3., 2 
DIR$ ,ERR 
•ENDM GMCX$S 



C.7.8 GREG$, GREG$C, and GREG$S Macros 

These macros get region parameters. They are a special case of the 
get partition parameters macros. 
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.MACRO GREG$ RID,BUF 

•MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 65., 4 

•WORD 0,RID 

.WORD BUF 

.ENDC 

.IF NDF G.RGID 

.NLIST 

OFF$ 

OFF$ ,2 

OFF? G.RGID, 2 

OFF$ G.RGBA,2 

•IF NDF G.RGRB 
$$$OST«0 

.IRP X,<<G.RGRB,2>,<G.RGRS,2>,<G.RGFW,2>> 

OFF$ X 

.ENDM 

.ENDC 

.LIST 

.ENDC 

.ENDM GREG$ 

.MACRO GREG$C RID, BUF, CS , ERR 

•MCALL GREG$,DIR$ 

.IF NDF $$$GLB 

.PSECT $DPB$$ 
$$$-. 

.IFTF 

GREG$ RID, BUF 

.IFT 

•PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM GREG$C 

•MACRO GREG$S RID, BUF, ERR 

•MCALL MOV$,DIR$,OFF$ 

MOV$ BUF 

MOV$ RID 

CLR -(SP) 

MOV (PC)+,-(SP) 

.BYTE 65 ,,4 

DIR$ ,ERR 

•IF NDF G.RGRB 

.NLIST 
$$$OST=0 

.IRP X,<<G.RGRB,2>,<G.RGRS,2>,<G.RGFW,2>> 

OFF$ X 

• ENDM 

• LIST 

• ENDC 
•ENDM GREG$S 



C.7.9 MAP$, MAP9C, MAP$S Macros 

These macros generate the code to map an address window. 

•MACRO MAP$ WDB 
•MCALL OFF$ 
•IF NDF $$$GLB 
.BYTE 121., 2 
.WORD WDB 
• ENDC 
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.IF NDF M.APBA 

OFF$ 

OFF$ M.APBA, 2 

.ENDC 

.ENDM MAP$ 

.MACRO MAP$C WDB,CS,ERR 
.MCALL. MAP$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

.IFTF 

MAP$ WDB 

.IFT 

•PSECT CS 

DIR$ #$■$$, ERR 

.ENDC 

.ENDM MAP$C 

•MACRO MAP$S WDB, ERR 

.MCALL DIR$,MOV$ 

MOV$ WDB 

MOV (PC)+,-<SP) 

.BYTE 121., 2 

DIR$ ,ERR 

.ENDM MAP$S 



C.7.10 RDBBK$ Macro 

RDBBK$ generates a region definition block. 

.MACRO RDBBK$ SIZ ,NAM,PAR,STS ,PRO 

.MCALL RDBDF$,R50$ 

RDBDF$ ;Define region definition block 

; symbols 
•WORD ; Region ID 

.WORD SIZ ;Size of region (32w blocks) 

R50$ NAM ;Name of region (RAD50) 

R50$ PAR ;Region's main partition name (RAD50) 

.WORD STS ; Region status word 

.WORD PRO ;Region protection word 

.ENDM RDBBK$ 



C.7.11 RREF$, RREF$C, and RREF$S Macros 

These macros generate the code to receive by reference. 

•MACRO RREF$ WDB 

•MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 81., 2 

.WORD WDB 

• ENDC 

.IF NDF R.REBA 

OFF$ 

OFF$ R.REBA, 2 

.ENDC 

.ENDM RREF$ 



C-107 



MACRO EXPANSIONS 



.MACRO RREF$C WDB, CS, ERR 
.MCALL RREF$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 

$$$-. 
.IFTF 
RREF$ WDB 
.IFT 

•PSECT CS 
DIR$ #$$$,ERR 
.ENDC 
.ENDM RREF$C 

.MACRO RREF$S WDB, ERR 

.MCALL DIR$,MOV$ 

MOV$ WDB 

MOV (PC)+,-(SP) 

•BYTE 81., 2 

DIR$ ,ERR 

•ENDM RREF$S 



C.7.12 SREF$, SREF$C, and SREF$S Macros 

These macros generate the code to send by reference. 

.MACRO SREF$ TASK, WDB, EFN 

•MCALL R50$ ,OFF$ 

.IF NDF $$$GLB 

.BYTE 69., 5 

R50$ TASK 

.WORD EFN 

.WORD WDB 

.ENDC 

.IF NDF S.RETN 

.IRP X,<,<S.RETN,4>,<S.REEF,2>,<S.REBA,2>> 

OFF$ X 

.ENDM 

.ENDC 

.ENDM SREF$ 

.MACRO SREF$C TASK , WDB, EFN ,CS , ERR 

.MCALL SREF$,DIR$ 

•IF NDF $$$GLB 

•PSECT $DPB$$ 



$$$ = 



.IFTF 

SREF$ TASK, WDB, EFN 

• IFT 

•PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM SREF$C 

.MACRO SREF$S TSKADR,WDB,EFN ,ERR 

•MCALL DIR$,MOV$,RFA$ 

MOV$ WDB 

MOV$ EFN 

RFA$ TSKADR 

MOV (PC)+,-(SP) 

•BYTE 69., 5 

DIR$ ,ERR 

•ENDM SREF$S 



C-108 



MACRO EXPANSIONS 

C.7.13 SRRA$, SRRA$C, and SRRA$S Macros 

These macros generate the code for the SPECIFY RECEIVE BY REFERENCE 
AST directive. 

.MACRO SRRA$ AST 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 21., 2 

.WORD AST 

.ENDC 

.IF NDF S.RRAE 

.NLIST 

OFF$ 

OFF$ S.RRAE, 2 

.LIST 

• ENDC 

.ENDM SRRA$ 

.MACRO SRRA$C AST, CS, ERR 
.MCALL SRRA$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$-. 



.IFTF 

SRRA$ AST 

.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

.ENDC 

.ENDM SRRA$C 

.MACRO SRRA$S AST, ERR 

.MCALL MOV$,DIR$ 

MOV$ AST 

MOV (PC)+,-(SP) 

.BYTE 21. ,2 

DIR$ ,ERR 

.ENDM SRRA$S 



C.7.14 UMAP$, UMAP.$C, and UMAP$S Macros 

These macros generate the code to unmap an address window. 

.MACRO UMAP$ WDB 

.MCALL OFF$ 

.IF NDF $$$GLB 

.BYTE 123., 2 

.WORD WDB 

. ENDC 

.IF NDF U.MABA 

OFF$ 

OFF$ U.MABA, 2 

.ENDC 

.ENDM UMAP$ 

.MACRO UMAP$C WDB, CS, ERR 
.MCALL UMAP$,DIR$ 
.IF NDF $$$GLB 
.PSECT $DPB$$ 



$$$=. 



.IFTF 
UMAP$ WDB 
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.IFT 

.PSECT CS 

DIR$ #$$$,ERR 

• ENDC 

•ENDM UMAP$C 



.MACRO UMAP$S WDB,ERR 

•MCALL DIR$,MOV$ 

MOV$ WDB 

MOV (PC)+,-(SP) 

.BYTE 123., 2 

DIR$ ,ERR 

•ENDM UMAP$S 



C.7.15 WDBBK$ Macro 

WDBBK? generates a window definition block. 

.MACRO WDBBK$ APR,SIZ ,RID ,OFF ,LEN ,STS ,SRB 

.MCALL WDBDF$ 

WDBDF$ ;Define window definition block 

; symbols 

.BYTE 0,APR ; Window ID / base APR. 

•WORD ;Virtual base address (bytes) 

.WORD SIZ ;Window size (32w blocks) 

.WORD RID ; Region ID 

.WORD OFF ;Offset in partition (32w blocks) 

•WORD LEN ; Length to map (32w blocks) 

•WORD STS ; Status word 

.WORD SRB ;Send/receive buffer virtual address 

.ENDM WDBBK$ 



C.8 RELATIVE FILES MACROS - EXPANSIONS 

C.8.1 RCLOS$ Macro 

RCLOS$ closes a file. 

.MACRO RCLOS$ FDB,ERR 
.MCALL LDFDB$,ERR$ 
LDFDBS FDB 
JSR PC.RCLOS 
ERR$ ERR 
•ENDM RCLOS$ 

C.8. 2 RFDBT$ Macro 

RFDBT$ defines the relative file descriptor bits. 

.MACRO RFDBT$ GLOBL 

.MCALL DEFIN$ 

. . .GBL = 

.IIF IDN,<GLOBL>,<DEF$G>, . . .GBL=1 

C-110 



MACRO EXPANSIONS 



Relative Pile Flags Byte 

DEPIN$ RF.WRT,1 

DEFIN$ RF.EXT,2 
DEFIN$ RF.BEX,4 

Relative File Value Byte 

DEFIN$ RB.NEW,1 
DEFIN$ RB.NCH,2 
DEFIN$ RB.VAL,4 
.MACRO RFDBT$ ARG 
.ENDM RFDBT$ 
• ENDM RFDBT$ 



;Set if bit table record 

? buffer dirty 

?Set if extend is allowed 

;Set if extend attempted when 

; restricted 



;New bit value to set 
;1 if not changing value 
;Bit value read 



C.8.3 RFIND$ Macro 

RFIND$ finds the next existing record, 

•MACRO RFIND$ FDB, LRCNM,HRCNM,ERR 

.MCALL LDFDB$ ,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W LRCNM,R.RCNM+2 

CMOV$W HRCNM,R.RCNM 

JSR PC.RFIND 

ERR$ ERR 

.ENDM RFIND$ 



C.8.4 RFOFSL Macro 

RFOF$L locally defines relative file record offsets. 

.MACRO RFOF$L 
.MCALL RFOFF$ 
RFOFF$ DEF$L 
.ENDM RFOF$L 



C.8.5 RFOFF$ Macro 

RFOFF$ defines the offsets for the relative file extension of the FDB. 

.MACRO RFOFF$ OFFSET 
.MCALL OFFSET, DEF$I,FDBSZ$ 
FDBSZ$ 
DEF$I S.FDB 



Relative File Record Section 



OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 



R.RCNM,4 
R.CLSZ,4 
R . FLAG , 1 
R.BTVL,1 
R.BTSZ,2 
R.BTBF,2 
R.BTN,2 
R . BTRC , 2 



; Relative record number 

;Cluster size 

; Flags byte 

;Value byte 

;Bit table record size 

;Bit table record buffer 

;Bit table number 

;Bit table record number 
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OFFSET S.RFD ;Size of RFDB 

.IIF IDN,<DEF?N>,<OFFSET>, .MEXIT 
.MACRO RFOFF$ ARG 
•ENDM RFOFF$ 
• ENDM RFOFF$ 



C.8.6 RGET$ Macro 

RGET$ gets a relative file. 

.MACRO RGET$ FDB, INADR,MAXCNT,LRCNM,HRCNM,ERR 

.MCALL LDFDB$,CMOV$W,ERR5 

LDFDB$ FDB 

CMOV$W INADR,F.URBD+2 

CMOV$W MAXCNT,F.URBD 

CMOV$W LRCNM,R.RCNM+2 

CMOV$W HRCNM,R.RCNM 

JSR PC.RGET 

ERR$ ERR 

.ENDM RGET$ 



C.8.7 ROPN$ Macro 

ROPN$ opens a file. 

.MACRO ROPN5 FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 

.MCALL FDOP$R,FDRC$R,ERR$,CMOV$B 

FDOP$R FDB,LUN,FNPT,DFNB,FACC 

FDRC$R ,RACC,URBA,URBS 

.GLOBL .ROPEN 

JSR PC,. ROPEN 

ERR$ ERR 

.ENDM ROPN$ 



C.8.8 ROPN$A Macro 

ROPN$A opens a file for appending. 

•MACRO ROPN$A FDB ,LUN ,FNPT ,RACC ,URBA ,URBS ,ERR 
.MCALL ROPN$ 

ROPN$ FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM ROPN$A 



C.8.9 ROPN$M Macro 

ROPN$M opens a file for modification. 

•MACRO ROPN$M FDB,LUN ,FNPT,RACC ,URBA,URBS ,ERR 
.MCALL ROPN$ 

ROPN$ FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
•ENDM ROPN$M 
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C.8.10 ROPN$R Macro 

ROPN$R opens a file for reading. 

•MACRO ROPN$R FDB, LUN ,FNPT, RACC ,URBA ,URBS , ERR 

.MCALL ROPN$ 

ROPN5 FDB,#FO.RD,LUN,FNPT, , RACC ,URBA,URBS , ERR 

.ENDM ROPN$R 



C.8.11 ROPN$D Macro 

ROPN$U opens a file for updating. 

.MACRO ROPN$U FDB, LUN ,FNPT, RACC ,URBA,URBS , ERR 

.MCALL ROPN$ 

ROPN$ FDB,#FO.UPD,LUN,FNPT, , RACC ,URBA ,URBS , ERR 

.ENDM ROPN$U 



C.8.12 ROPN$W Macro 

ROPN$W opens a file for writing. 

.MACRO ROPN$W FOB, LUN ,FNPT, RACC ,URBA ,URBS , ERR 

.MCALL ROPN? 

ROPN$ FDB, IFO.WRT, LUN, FNPT,, RACC, URBA,URBS, ERR 

.ENDM ROPN$W 



C.8.13 ROPS$A Macro 

ROPS$A opens a shared file for appending. 

.MACRO ROPS$A FDB ,LUN ,FNPT, RACC ,URBA ,URBS , ERR 

.MCALL ROPN$ 

ROPN$ FDB,#FA.SHR1F0.APD,LUN,FNPT, , RACC ,URBA,URBS , ERR 

.ENDM ROPS$A 



C.8.14 ROPS$M Macro 

ROPS$M opens a shared file for modification. 

.MACRO ROPS$M FDB, LUN ,FNPT, RACC ,URBA ,URBS , ERR 

.MCALL ROPN$ 

ROPN$ FDB,#FA.SHR!FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 

.ENDM ROPS$M 



C.8.15 ROPS$R Macro 

ROPS$R opens a shared file for reading. 

.MACRO ROPS$R FDB , LUN ,FNPT , RACC ,URBA,URBS , ERR 

.MCALL ROPN? „ „_ 

ROPN$ FDB, #FA.SHR!FO.RD, LUN, FNPT,, RACC, URBA,URBS, ERR 

.ENDM ROPS$R 
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C.8.16 ROPS5U Macro 

ROPS$CJ opens a shared file for updating. 

.MACRO ROPS$U FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
.MCALL ROPN$ 

ROPN$ FDB,#FA.SHR!FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM ROPS$U 



C.8.17 ROPS$W Macro 

ROPS$W opens a shared file for writing. 

•MACRO ROPS$W FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
.MCALL ROPN$ 

ROPN$ FDB , # FA. SHR ! FO . WRT ,LUN ,FNPT , , RACC , URBA ,URBS ,ERR 
•ENDM ROPS$W 



C.-8.18 RPORT$ Macro 

RPORT$ reports the existence of a record for a relative file. 

.MACRO RPORT$ FDB,LRCNM, HRCNM, ERR 
.MCALL RPRTC$ 

RPRTC$ <FDB> , #-1 , <LRCNM> , <HRCNM> , <ERR> 
.ENDM RPORT$ 



C.8.19 RPRTC$ Macro 

RPRTC$ reports on and optionally changes the existence of a record, 

•MACRO RPRTC$ FDB, CHGVAL ,LRCNM, HRCNM, ERR 

•MCALL LDFDB$ ,CMOV$W,CMOV$B,ERR$ 

LDFDB$ FDB 

CMOV$B CHGVAL, R.BTVL 

CMOV$W LRCNM,R.RCNM+2 

CMOV$W HRCNM, R.RCNM 

JSR PC.RPRTC 

ERR$ ERR 

•ENDM RPRTC$ 



C.8.20 RPOT$ Macro 

RPUT$ puts a relative file. 

.MACRO RPUT$ FDB, OUTADR,OUTCNT,LRCNM, HRCNM, ERR 

.MCALL LDFDB$,CMOV$W,ERR$ 

LDFDB$ FDB 

CMOV$W OUTADR,F.NRBD+2 

CMOV$W OUTCNT,F.NRBD 

CMOV$W LRCNM,R.RCNM+2 

CMOV$W HRCNM, R.RCNM 

JSR PC, .RPUT 

ERR$ ERR 

.ENDM RPUT$ 
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C.9 QIOMAC - QIOSYM MACRO DEFINITIONS 



C.9.1 DRERR$ Macro 

Defines the directive error codes returned in the directive status 
word. File control services (FCS) returns these codes in the F.ERR 
byte of the File Descriptor Block (FDB) . To distinguish them from the 
overlapping codes from handler and file primitives, the F.ERR+1 byte 
in the FDB is negative for a directive error code. 

.MACRO DRERR$ $$$GBL 

.MCALL .QIOE.,DEFIN$ 

.IF IDN,<$$$GBL>,<DEF$G> 

. . .GBL=1 

.IFF 

...GBL=0 

.ENDC 

.IIF NDF,$$MSG,$$MSG=0 

Standard Error Codes Returned by Directives in the Directive Status 
Word 



.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

•QIOE. 

•QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

•QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

•QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 

.QIOE. 



IE.UPN,- 

IE.INS,- 

IE.PTS,- 

IE.UNS,- 

IE.ULN,- 

IE.HWR,- 

IE.ACT,- 

IE.ITS,- 

IE.FIX,- 

IE.CKP,- 

IE.TCH,- 

IE.RBS,- 

IE.PRI," 

IE.RSU,- 

IE. NSW, ■ 

IE.ILV,- 

IE. AST, • 

IE. MAP, • 

IE.IOP,- 

IE.ALG,' 

IE.WOV,- 

IE.NVR,' 

IE.NVW,' 

IE.ITP, 

IE. IBS, 

IE.LNL, 

IE.IUI, 

IE.IDU, 

IE.ITI, 

IE.PNS, 

IE.IPR, 

IE.ILU, 

IE.IEF, 

IE.ADP, 

IE.SDP, 



•01., INSUFFICIENT DYNAMIC STORAGE> 

02.,<SPECIFIED TASK NOT INSTALLED> 

03.,<PARTITION TOO SMALL FOR TASK> 

■04.,<INSUFFICIENT DYNAMIC STORAGE FOR SEND> 

•05.,<UN-ASSIGNED LUN> 

•06.,<DEVICE HANDLER NOT RESIDENT> 

•07.,<TASK NOT ACTIVE> 

■08., DIRECTIVE INCONSISTENT WITH TASK STATE> 

•09.,<TASK ALREADY FIXED/UNFIXED> 

•10.,<ISSUING TASK NOT CHECKPOINTABLE> 

•11.,<TASK IS CHECKPOINTABLE> 

-15. ,<RECEIVE BUFFER IS TOO SMALL> 

-16., PRIVILEGE VIOLATION> 

-17.,<RESOURCE IN USE> 

-18.,<NO SWAP SPACE AVAILABLE> 

-19. ,<ILLEGAL VECTOR SPECIFIED> 

-80.,<DIRECTIVE ISSUED/NOT ISSUED FROM AST> 

-81. ,<ILLEGAL MAPPING SPECIFIED> 

-83.,<WINDOW HAS I/O IN PROGRESS> 

-84.,<ALIGNMENT ERROR> 

-85.,<ADDRESS WINDOW ALLOCATION OVERFLOW> 

-86.,<INVALID REGION ID> 

-87. ,<INVALID ADDRESS WINDOW ID> 

-88. ,<INVALID TI PARAMETER> 

-89.,<INVALID SEND BUFFER SIZE ( .GT. 255. )> 

-90.,<LUN LOCKED IN USE> 

-91.,<INVALID UIO 

-92.,<INVALID DEVICE OR UNIT> 

-93. ,<INVALID TIME PARAMETERS> 

-94. ,<PARTITION/REGION NOT IN SYSTEM> 

-95.,<INVALID PRIORITY ( .GT. 250. )> 

-96. ,<INVALID LUN> 

-97.,<INVALID EVENT FLAG ( .GT. 64.) > 

-98.,<PART OF DPB OUT OF USER'S SPACE> 

-99.,<DIC OR DPB SIZE INVALID> 
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Success Codes from Directives - Placed in the Directive Status Word 
DEFIN$ IS.CLR,0 
DEFIN$ IS. SET, 2 



DEFIN$ IS.SPD,2 
.IF EQ,$$MSG 
.MACRO DRERR$ A 
.ENDM DRERR$ 
• ENDC 
.ENDM DRERR? 



Event flag was clear 

from CLEAR EVENT FLAG, directive 
Event flag was set 

from SET EVENT FLAG directive 
Task was suspended 



C.9.2 FILIO$ Macro 

FILIO$ defines the general QIO function codes that are device 
independent. 

MACRO FILIO$ $$$GBL 

MCALL .WORD.,DEFIN$ 

IF IDN,<$$$GBL>,<DEF$G> 

. .GBL=1 

IFF 

. .GBL»0 

General QIO Qualifier Byte Definitions 



.WORD. IQ.X,001,000 

.WORD. IQ.Q,002,000 

.WORD. IQ.S,004,000 

.WORD. IQ.UMD,004,000 

Express Queue Commands 

.WORD. IO.KIL,012,000 

.WORD, IO.RDN,022,000 

.WORD. IO.UNL,042,000 

.WORD. IO.LTK,050,000 

•WORD. 10. RTK, 060,000 

.WORD. IO. SET, 030, 000 



;No error recovery 

;Queue request in express queue 

; Synonym for IQ.UMD 

;User mode diagnostic status required 



;Kill current request 

; I/O rundown 

; Unload I/O handler task 

;Load a task image file 

; Record a task image file 

;Set characteristics function 



General Device Handler Codes 



.WORD. IO.WLB,000,001 

.WORD. IO.RLB,000,002 

.WORD. IO.LOV,010,002 

.WORD. IO. ATT, 000, 003 

.WORD. IO.DET,000,004 



;Write logical block 
;Read logical block 
;Load overlay (disk driver) 
;Attach a device to a task 
;Detach a device from a task 



Directory Primitive Codes 

.WORD. IO.FNA,000,011 
.WORD. IO.RNA,000,013 
.WORD. IO.ENA,000,014 

File Primitive Codes 

.WORD. IO.CLN,000,007 

.WORD. IO.ULK,000,012 

.WORD. IO.ACR,000,015 

.WORD. IO.ACW,000,016 

•WORD. IO. ACE, 000, 017 



;Find file name in directory 

; Remove file name from directory 

;Enter file name in directory 



; Close out LUN 
/Unlock block 
;Access for read 
{Access for write 
;Access for extend 
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•WORD. 

.WORD. 

.WORD. 

.WORD. 

.WORD. 

•WORD. 

.WORD. 

.WORD. 

.WORD. 

. WORD . 

.MACRO 

• ENDM 

.ENDM 



IO.DAC 
IO.RVB 
IO.WVB 
10. EXT 
IO.CRE 
10. DEL 
10. RAT 
10. WAT 
IO.APV 
IO.APC 
FILIO$ 
FILIO$ 
FILIO$ 



,000,020 ;De-access file 

,000,021 ;Read viritual block 

,000,022 ;Write virtual block 

,000,023 ;Extend file 

,000,024 jCreate file 

,000,025 ;Delete file 

,000,026 ;Read file attributes 

,000,027 ;Write file attributes 

,010,030 ,-Privileged ACP control 

,000,030 ;ACP control 
A 



C.9.3 .IOER. Macro 

This macro defines handler error codes that are returned in the I/O 
status block are defined through this macro. This macro then 
conditionally invokes the message generating macro for the QIOSYM.MSG 
file. 

.MACRO .IOER. SYM,LO,MSG 
DEFIN$ SYM,LO 
•IF GT,$$MSG 
•MCALL .IOMG. 
.IOMG. SYM,LO,<MSG> 
• ENDC 
.ENDM .IOER. 



C.9.4 IOERR$ Macro 

This macro defines the error codes returned by device handlers and 
file primitives in the first word of the I/O status block. The File 
Control Services also return these codes in the F.ERR byte in the File 
Descriptor Block (FDB) . The F.ERR+1 byte is if F.ERR contains a 
handler or FCP error code. 

.MACRO IOERR? $$$GBL 

.MCALL .IOER. ,DEFIN$ 

.IF IDN,<$$$GBL>,<DEF$G> 

. . .GBL=1 

.IFF 

■. ..GBL=0 

.ENDC 

.IIF NDF,$$MSG,$$MSG=0 

System standard codes, used by executive and drivers: 

.IOER. IE.BAD,-01.,<BAD PARAMETERS> 

.IOER. IE.IFC,-02.,<INVALID FUNCTION CODE> 

.IOER. IE.DNR,-03.,<DEVICE NOT READY> 

.IOER. IE.VER,-04. ,<PARITY ERROR ON DEVICE> 

.IOER. IE.ONP,-0 5.,<HARDWARE OPTION NOT PRESENT> 

.IOER. IE.SPC-06. ,<ILLEGAL USER BUFFER> 

.IOER. IE.DNA,-07.,<DEVICE NOT ATTACHED> 

.IOER. IE.DAA,~08.,<DEVICE ALREADY ATTACHED> 

.IOER. IE.DUN,-09.,<DEVICE NOT ATTACHABLE> 

•IOER. IE.EOF,-10.,<END OF FILE DETECTED> 

.IOER. IE.EOV,-ll. ,<END OF VOLUME DETECTED> 

.IOER. IE.WLK,-12. ,<WRITE ATTEMPTED TO LOCKED UNIT> 
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.IOER. IE.DAO,-13.,<DATA OVERRUN> 
.IOER. IE.SRE,-14.,<SEND/RECEIVE FAILURE> 
.IOER. IE.ABO,-15.,<REQUEST TERMINATED> 
.IOER. IE.PRI,-16.,<PRIVILEGE VIOLATION> 
.IOER. IE.RSU,-17.,<SHARABLE RESOURCE IN USE> 
.IOER. IE. OVR, -18., < ILLEGAL OVERLAY REQUEST> 
.IOER. IE.BYT,-19.,<ODD BYTE COUNT (OR VIRTUAL ADDRESS) > 
.IOER. IE.BLK,-20.,<LOGICAL BLOCK NUMBER TOO LARGE> 
•IOER. IE. MOD, -21., < INVALID UDC MODULE #> 
.IOER. IE.CON,-22.,<UDC CONNECT ERROR> 
•IOER. IE.BBE,-56.,<BAD BLOCK ON DEVICE> 

.IOER. IE.STK,-58.,<NOT ENOUGH STACK SPACE (FCS OR FCP) > 
.IOER. IE.FHE,-59.,<FATAL HARDWARE ERROR ON DEVICE> 
•IOER. IE.EOT,-62.,<END OF TAPE DETECTED> 
.IOER. IE.OFL,-65.,<DEVICE OFF LINE> 

•IOER. IE.BCC,-66.,<BLOCK CHECK, CRC, OR FRAMING ERROR> 
File Primitive Codes 

.IOER. IE.NOD,-23.,<CALLER'S NODES EXHAUSTED> 

•IOER. IE.DFU,-24.,<DEVICE FULL> 

.IOER. IE.IFU,-25.,<INDEX FILE FULL> 

.IOER. IE.NSF,-26.,<NO SUCH FILE> 

.IOER. IE. LCK, -27., CLOCKED FROM READ/WRITE ACCESS> 

.IOER. IE.HFU,-28.,<FILE HEADER FULL> 

•IOER. IE.WAC,-29.,<ACCESSED FOR WRITE> 

.IOER. IE.CKS,-30.,<FILE HEADER CHECKSUM FAILURE> 

•i°!S" IE ' WAT '- 31 " ATTRIBUTE CONTROL LIST FORMAT ERROR> 

•IOER. IE.RER,-32.,<FILE PROCESSOR DEVICE READ ERROR> 

.IOER. IE.WER,-33.,<FILE PROCESSOR DEVICE WRITE ERROR> 

.IOER. IE.ALN,-34.,<FILE ALREADY ACCESSED ON LUN> 

.IOER. IE.SNC,-35.,<FILE ID, FILE NUMBER CHECK> 

.IOER. IE.SQC,-36.,<FILE ID, SEQUENCE NUMBER CHECK> 

.IOER. IE.NLN,-37.,<NO FILE ACCESSED ON LUN> 

.IOER. IE.CLO,-38.,<FILE WAS NOT PROPERLY CLOSED> 

.IOER. IE.DUP,-57.,<ENTER - DUPLICATE ENTRY IN DIRECTORY> 

.IOER. IE.BVR,-63.,<BAD VERSION NUMBER> 

•IOER. IE.BHD,-64.,<BAD FILE HEADER> 

.IOER. IE.EXP,-75.,<FILE EXPIRATION DATE NOT REACHED> 

.IOER. IE.BTF,-76. ,<BAD TAPE FORMAT> 

.IOER. IE.ALC,-84.,<ALLOCATION FAILURE> 

.IOER. IE.ULK,-85.,<UNLOCK ERROR> 

-IOER. IE.WCK,-86.,<WRITE CHECK FAILURE> 

File Control Services Codes 



.IOER. 
.IOER. 
.IOER. 
.IOER. 

.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
•IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
IOER. 



IE.NBF,- 
IE.RBG,- 
IE.NBK,- 
IE.ILL,- 

IE.BTP,- 
IE.RAC,- 
IE.RAT,- 
IE.RCN,- 
IE.2DV,- 
IE.FEX,- 
IE.BDR,- 
IE.RNM,- 
IE.BDI,- 
IE.FOP,- 
IE.BNM,- 
IE.BDV,- 
IE.NFI,- 



-39. 
•40. 
•41. 
•42. 

■43. 
•44. 
■45. 
■46. 
■48. 
•49. 
•50. 
•51. 
52. 
53. 
54. 
55. 
60. 



,<OPEN - NO BUFFER SPACE AVAILABLE FOR FILE> 
,<ILLEGAL RECORD SIZE> 

,<FILE EXCEEDS SPACE ALLOCATED, NO BLOCKS> 
,<ILLEGAL OPERATION ON FILE DESCRIPTOR 

BLOCK > 
,<BAD RECORD TYPE> 

,< ILLEGAL RECORD ACCESS BITS SET> 
,<ILLEGAL RECORD ATTRIBUTES BITS SET> 
,<ILLEGAL RECORD NUMBER - TOO LARGE> 
,<RENAME - 2 DIFFERENT DEVICES> 
,<RENAME - NEW FILE NAME ALREADY IN USE> 
,<BAD DIRECTORY FILE> 
,<CANNOT RENAME OLD FILE SYSTEM> 
,<BAD DIRECTORY SYNTAX> 
,<FILE ALREADY OPEN> 
,<BAD FILE NAME> 
,<BAD DEVICE NAME> 
, <FILE ID WAS NOT SPECIFIED> 
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.IOER. IE.ISQ,-61.,<ILLEGAL SEQUENTIAL OPERATION 
.IOER. IE.NNC,-77.,<NQT ANSI 'D' FORMAT BYTE COUNT> 



Network ACP Codes 



.IOER. 


IE .AST, • 


-80 


.IOER. 


IE.NNN,- 


-68 


.IOER. 


IE.NFW, 


-69 


.IOER. 


IE.BLB, 


-70 


.IOER. 


IE.TMM, 


-71 


•IOER. 


IE.NDR, 


-72 


.IOER. 


IE. CNR, 


-73 


.IOER. 


IE.TMO, 


-74 


.IOER. 


IE.NNL, 


-78 



,<NO AST SPECIFIED IN CONNECT> 

,<NO SUCH NODE> 
, ,<PATH LOST TO PARTNER> ;This code must be 

; odd 
,,<BAD LOGICAL BUFFER> 
,,<TOO MANY OUTSTANDING MESSAGES> 
, ,<NO DYNAMIC SPACE AVAILABLE> 
,, CONNECTION REJECTED> 
. , <TIMEOUT ON REQUEST> 
. ,<NOT A NETWORK LUN> 



ICS/ICR Error Codes 



IOER. IE.NLK,-79.,<TASK NOT LINKED TO SPECIFIED ICS/ICR 

INTERRUPTS > 
IOER. IE. NST, -80., SPECIFIED TASK NOT INSTALLED> 
'IOER! Ie!fLN,-81.!<DEVICE OFFLINE WHEN OFFLINE REQUEST WAS 

ISSUED> 



TTY Error Codes 

IOER. IE.IES,-82.,<INVALID ESCAPE SEQUENCE> 
.IOER. IE.PES,-83.,<PARTIAL ESCAPE SEQUENCE> 



Successful Return Codes: 

DEFIN$ IS.PND,+00. 
DEFIN$ IS. SUC, + 01. 
DEFIN$ IS.RDD,+02. 



DEFIN$ IS.BV,+05. 



Operation pending 

Operation complete, success 

(RX11) Floppy disk successful 
completion of a read physical 
and a deleted data mark was 
seen in the sector header of 
the last sector. 

(A/D READ) At least one bad value 
was read (remainder may be good) ; 
bad channel is indicated by a 
negative value in the buffer. 



TTY Success Codes 

DEFIN$ IS.CR,<15*400+1> 
DEFIN$ IS.ESC,<33*400+1> 
DEFIN$ IS.CC,<3*400+1> 
DEFIN$ IS.ESQ,<233*400+1> 
DEFIN? IS.PES,<200*400+1> 
DEFIN$ IS.EOT,<4*400+1> 

DEFIN$ IS.TAB,<11*400+1> 

DEFIN$ IS.TMO,+2. 

.IF EQ,$$MSG 

.MACRO IOERR$ A 

.ENDM IOERR$ 

• ENDC 

.ENDM IOERR$ 



Carriage return was terminator 
Escape (ALTMODE) was terminator 
CONTROL-C was terminator 
Escape sequence was terminator 
Partial escape sequence terminator 
EOT was terminator (block mode 

input) 
TAB was terminator (forms mode 

input) 
Request timed out 
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C.9.5 .QIOE. Macro 

This macro defines the QIO error codes. This macro then invokes the 
error message generating macro, ".IOMG.". The QIOSYM.MSG file uses 
error codes -129 through -256. 

.MACRO .QIOE. SYM,LO,MSG 

DEFIN$ SYM,LO 

.IF GT,$$MSG 

.MCALL .IOMG. 

.IOMG. SYM,<LO-128.>,<MSG> 

.ENDC 

.ENDM .QIOE. 

Conditional Data for Writing a Message File 

.MACRO .IOMG. SYM,LO,MSG 
•WORD -~0<LO> 

.ASCIZ *MSG* 
• EVEN 
.IIF LT,"0<$$$MAX+<LO>>,$S$MAX=-*0<LO> 

.ENDM .IOMG. 



C.9.6 QIOSY$ Macro 

This macro defines standard QUEUE I/O directive function values and 
IOSB return values. To invoke at assembly time (with local 
definition) use: 

QIOSY? ; Define symbols 

To obtain global definition of these symbols use: 

QIOSY? DEF$G ; Symbols defined globally 

This macro can be called once only. It then redefines itself as a 
null. 

.MACRO QIOSY$ $$$GBL ,$$$MSG 

.IIP IDN,<$$$GBL>,<DEF$G>, .GLOBL QI .VER 

.IF IDN,<$$$MSG>,<DEF$S> 

$$$MAX=0 

$$MSG=1 

.IFF 

$$MSG=0 

• ENDC 
.MCALL IOERR$ 

IOERR$ $$$GBL ;I/0 error codes from handlers, FCP, 

; FCS 
.MCALL DRERR$ 

DRERR$ $$$GBL ?Directive status word error codes 

•IF DIF,<$$$MSG>,<DEF$S> 
•MCALL FILIO$ 

FILIO$ $$$GBL ;Define general QIO function codes 

.MCALL SPCIO$ 

SPCIO$ $$$GBL ;Device dependent I/O function codes 

•MACRO QIOSY$ ARG ,ARG1 ,ARG2 ; Reclaim macro storage 
.ENDM QIOSY$ 

• ENDC 

•ENDM QIOSY$ 
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C.9.7 SPCIO$ Macro 

Defines the QIO function codes that are specific to individual 
devices. 



MACRO SPCIO$ $$$GBL 

MCALL .WORD.,DEFIN$ 

IF IDN,<$$$GBL>,<DEF$G> 

. .GBL=1 

IFF 

. .GBL=0 

ENDC 

QIO Function Codes for Specific Device Dependent Functions 



.WORD. 
.WORD. 
.WORD. 
.WORD. 
.WORD. 
•WORD. 
. WORD . 
. WORD . 
.WORD. 
.WORD. 
.WORD. 

•WORD. 
. WORD . 
.WORD. 
.WORD. 
.WORD. 
. WORD . 
. WORD . 
.WORD. 
. WORD . 
. WORD . 
•WORD. 
.WORD. 
. WORD . 

.WORD. 
. WORD . 
•WORD. 
.WORD. 
.WORD. 
. WORD . 
•WORD. 
. WORD . 
.WORD. 
•WORD. 
•WORD. 
. WORD . 

.WORD. 
. WORD . 
.WORD. 
. WORD . 
.WORD, 
.WORD. 
.WORD. 
. WORD . 
.WORD. 
•WORD. 



IO.WLV 
IO.WLS 
IO.WNS 
IO.WAL 
IO.WMS 
10. CCO 
IO.WBT 
IO.WLT 
IO.WLC 
IO.WPB 
IO.WDD 

10 . RLV 
IO.RST 
IO.RAL 
10 . RNE 
IO.RNC 
IO.RTM 
IO.RDB 
IO.RHD 
IO.RNS 
IO.CRC 
IO.RPB 
10. ATA 
10. GTS 



,100 
,010 
,020 
,010 
,020 
,040 
,100 
,010 
,020 
,040 
,044 

,100 
,001 
,010 
,020 
,040 
,200 
,200 
,010 
,020 
,040 
,040 
,010 
,000 



IO.R1C,000 
IO.INL,000 
IO.TRM,010 
IO.RWD,000 
IO.SPB,020 
IO.SPF,040 
IO.STC100 
IO. SEC, 120 
IO.RWU,140 
IO.SMO,160 
IO.HNG,000 
IO.RBC,000 

IO. MOD, 000 
IO.HDX,010 
IO.FDX,020 
IO.SYN,040 
IO. EOF, 000 
IO.RTC000 
IO. SAO, 000 
IO.SSO,000 
IO. RPR, 000 
IO.MSO,000 



,001 
,001 
,001 
,001 
,001 
,001 
,001 
,001 
,001 
,001 
,001 

,002 
,002 
,002 
,002 
,002 
,002 
,002 
,002 
,002 
,002 
,002 
,003 
,005 

,005 
,005 
,005 
,005 
,005 
,005 
,005 
,005 
,005 
,005 
,006 
,006 

,006 
,006 
,006 
,006 
,006 
,007 
,010 
,011 
,011 
,012 



(DECTAPE) Write logical reverse 
(COMM.) Write preceded by sync train 
(COMM.) Write, no sync train 
(TTY) Write passing all characters 
(TTY) Write suppressible message 
(TTY) Write with cancel CONTROL-o 
(TTY) Write with breakthrough 
(DISK) Write last track on RK06 
(DISK) Write logical with write check 
(RX11 DISK) Write physical block 
(RXll DISK) Write physical with 

; deleted data 
(MAGTAPE, DECTAPE) Read reverse 
(TTY) Read with special terminator 
(TTY) Read passing all characters 
(TTY) Read without echo 
(TTY) Read - no lower case convert 
(TTY) Read with time out 
(CARD READER) Read binary mode 
(COMM.) Read, strip sync 
(COMM.) Read, do not strip sync 
(COMM.) Read, do not clear CRC 
(RXll DISK) Read physical block 
(TTY) Attach with ASTs 
(TTY) Get terminal support 

; characteristics 
(AFC,AD01 ,UDC) Read single channel 
(COMM.) Initialization function 
(COMM.) Termination function 
(MAGTAPE, DECTAPE) Rewind 
(MAGTAPE) Space "N" blocks 
(MAGTAPE) Space "N" EOF marks 
(MAGTAPE) Set characteristic 
(MAGTAPE) Sense characteristic 
(MAGTAPE, DECTAPE) Rewind and unload 
(MAGTAPE) Mount & set characteristics 
(TTY) Hangup dial-up line 
Read multichannels (buffer 

; defines channels) 
(COMM.) Setmode function family 
(COMM.) Set unit half duplex 
(COMM.) Set unit full duplex 
(COMM.) Specify sync character 
(MAGTAPE) Write EOF 
Read channel - time based 
(UDC) Single channel analog output 
(UDC) Single shot, single point 
(TTY) Read with prompt 
(UDC) Single shot, multi-point 
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.WORD. 


10. 


SLO,000 


013 


.WORD. 


10. 


MLO,000 


,014 


.WORD. 


10. 


LED, 000 


,024 


. WORD . 


10. 


SDO,000 


025 


. WORD . 


10 


SDI,000 


,026 


.WORD . 


10 


SCS,000 


026 


.WORD. 


10. 


REL,000 


027 


•WORD. 


10 


MCS,000 


,027 


•WORD. 


10 


ADS, 000 


,030 


.WORD. 


10 


CCI,000 


,030 


.WORD. 


10 


MDI,000 


,031 


. WORD . 


10 


DCI,000 


,031 


.WORD. 


10 


XMT,000 


,031 


.WORD. 


10 


.XNA,010 


,031 


•WORD. 


10 


.HIS, 000 


,032 


.WORD. 


10 


.RCI,000 


,032 


.WORD. 


10 


,RCV,000 


,032 


.WORD. 


10 


.MDO,000 


,033 


.WORD. 


10 


.CTI,000 


,033 


. WORD . 


10 


.CON, 000 


,033 


.WORD. 


10 


.CPR,010 


,033 


.WORD. 


10 


.CAS, 020 


,033 


.WORD. 


10 


.CRJ,040 


,033 


. WORD . 


10 


.CBO,110 


,033 


. WORD . 


10 


.CTR,210 


,033 


.WORD. 


10 


.GNI,010 


,035 


. WORD , 


10 


.GLI,020 


,035 


. WORD . 


10 


,GLC,030 


,035 


.WORD. 


10 


.GRI,040 


,035 


. WORD . 


10 


.GRC050 


,035 


.WORD. 


10 


.GRN,060 


,035 


.WORD. 


10 


.CSM,070 


,035 


.WORD. 


10 


.CIN,100 


,035 


.WORD. 


10 


.SPW,110 


,035 


.WORD. 


10 


.CPW,120 


,035 


•WORD. 


10 


.NLB,130 


,035 


.WORD. 


10 


.DLB,140 


,035 


. WORD . 


10 


.STD,000 


,033 


.WORD. 


10 


.DTI, 000 


,034 


.WORD. 


10 


.DIS,000 


,034 



.WORD. IO.MDA,000,034 
.WORD. IO.RTI,000,035 
.WORD. IO.CTL,000,035 
.WORD. IO.STP,000,035 

.WORD. IO.CNT,000,036 
.WORD. IO.ITI,000,036 



(UDC) Latching, single point 
(UDC) Latching, multi-point 
(LPS11) Write LED display lights 
(LPS11) Write digital output register 
(LPS11) Read digital input register 
(UDC) Contact sense, single point 
(LPS11) Write relay 
(UDC) Contact sense, multi-point 
(LPS11) Synchronous A/D sampling 
(UDC) Contact int - connect 
(LPS11) Synchronous digital input 
(UDC) Contact int - disconnect 
(COMM.) Transmit specified block 

with ACK 

(COMM.) Transmit without ACK 
(LPS11) Synchronous histogram 

sampling 

(UDC) Contact int - read 
(COMM.) Receive data in buffer 

specified 

(LPS11) Synchronous digital output 
(UDC) Timer - connect 
(COMM.) Connect function 
(VTll) - Connect task to display 

processor 

(COMM.) Connect no timeouts 
(COMM.) Connect with AST 
(COMM.) Connect ' reject 
(COMM.) Boot connect 
(COMM.) Transparent connect 
(COMM.) Get node information 
(COMM.) Get link information 
(COMM.) Get link information - 

clear counters 

(COMM.) Get remote node information 
(COMM.) Get remote node error counts 
(COMM.) Get remote node name 
(COMM.) Change solo mode 
(COMM.) Change connection inhibit 
(COMM.) Specify network password 
(COMM.) Check network password. 
(COMM.) NSP loopback 
(COMM.) DDCMP loopback 
(LPAll) Start data transfer 
(UDC) Timer - disconnect 
(COMM.) Disconnect function 
(VTll) - Disconnect task from 

display processor 
(LPS11) Synchronous D/A output 
(UDC) Timer - read 
(COMM.) Network control function 
(LPS11) Stop in progress function 
(VTll) - Stop display processor 
(VTll) - Continue display processor 
(UDC) Timer - initialize 



ICS/ICR QIO Functions 



.WORD. IO.CTY,000,007 

.WORD. IO.DTY,000,015 

.WORD. IO.LDI,000,016 

.WORD. IO.UDI,010,023 

.WORD. IO.LTI,000,017 



Connect to terminal interrupts 
Disconnect from terminal interrupts 
Link to digital interrupts 
Unlink from digital interrupts 
Link to counter module interrupts 
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.WORD. IO.UTI,020,023 

.WORD. IO.LTY,000,020 
.WORD. IO.UTY,030,023 

.WORD. IO.LKE,000,024 

.WORD. IO.UER,040,023 

.WORD. IO.NLK,000,023 

.WORD. IO.ONL,000,037 

.WORD. IO.FLN,000,025 

.WORD. 10. RAD, 000, 021 



Unlink from counter module 

interrupts 
Link to remote terminal interrupts 
Unlink from remote terminal 

interrupts 
Link to error interrupts 
Unlink from error interrupts 
Unlink from all interrupts 
Unit online 
Unit offline 
Read activating data 



IP11 I/O Functions 



WORD. 


IO. MAO 


,010 


,007 


WORD. 


10. LEI 


,010 


,017 


WORD. 


IO.RDD 


,010 


,020 


WORD. 


IO.RMT 


,020 


,020 


WORD. 


IO.LSI 


,000 


,022 


WORD. 


IO.UEI 


,050 


,023 


WORD. 


IO.USI 


,060 


,023 


WORD. 


IO.CSI 


,000 


,026 


WORD. 


IO.DSI 


,000 


,027 


MACRO 


SPCIO$ 


A 




ENDM 


SPCIO$ 






ENDM 


SPCIO$ 







;Multiple analog outputs 
;Link event flags to interrupt 
;Read digital data 
;Read mapping table 
;Link to DSI interrupts 
;Unlink event flags 
;Unlink from DSI interrupts 
.•Connect to DSI interrupts 
.•Disconnect from DSI interrupts 



C.9.8 UMDIO$ Macro 

Defines the I/O codes for user-mode diagnositcs. All diagnostic 
functions are implemented as a subfunction of I/O code 10 (octal) . 

.MACRO UMDIO$ $$$GBL 

.MCALL .WORD.,DEFIN$ 

.IF IDN <$$$GBL>,<DEF$G> 
• ■ #GBL = 1 

.IFF 
. . .GBL=0 

.ENDC 

General User-mode Qualifier Bit 

.WORD. IQ.UMD,004 ,000 ;User mode diagnostic request 

User-mode Diagnostic Functions. 

(DISK) Home seek or recalibrate 
(DISK) Block seek 
(DISK) Offset position 
(DISK) Read disk header 
(DISK) Write disk header 
(DISK) Writecheck (non-transfer) 
(DECTAPE) Read block number forward 
(DECTAPE) Read block number reverse 
(MAGTAPE) Read longitudinal parity 
character 
(MAGTAPE) Erase tape 



WORD. 


IO 


HMS,000 


,010 


WORD. 


IO 


BLS,010 


,010 


WORD. 


IO 


OFF, 020 


,010 


WORD. 


IO 


.RDH,030 


,010 


WORD. 


IO 


.WDH,040 


,010 


WORD. 


IO 


.WCK,050 


,010 


WORD. 


IO 


,RNF,060 


,010 


WORD. 


IO 


.RNR,070 


,010 


WORD. 


IO 


.LPC,100 


,010 



.WORD. IO.ERS,110,010 

Macro Redefinition to Null 

.MACRO UMDIO$ A 
.ENDM 
.ENDM UMDIO$ 
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C.9.9 .WORD. Macro 

This macro defines the symbol SYM where LO is the low order byte and 
HI is the high byte. 

.MACRO .WORD. SYM,LO,HI 
DEFIN? SYM,<"O<HI*400+LO>> 
.ENDM .WORD., 



CIO SNAP CONTROL BLOCK AND SNAPSHOT DUMP MACROS 

The following macros are the macros for the snapshot dump debugging 
aid. 



C.10.1 SNAP? Macro 

SNAP? requests a snpashot dump. 

.MACRO SNAP? CTL,EFN,ID,Ll,Hl,L2,H2,L3,H3,L4,H4,?LBLI,?LBL2 

.MCALL SNPDF?,WTSE?S,SDAT?S,RQST?S,CLEF?S 

SNPDF? 

.IIP NB <CTL>, MOV CTL,. .SPBK+SB.CTL 

• IIF NB <EFN>, MOV EFN , . .SPBK+SB.EFN 
.IIF NB <ID>, MOV ID,. .SPBK+SB.ID 

. . .SNP = SB.LM1 

. IRP X, <L1 ,H1 ,L2 ,H2 ,L3 ,H3 ,L4 ,H4> 

.IF NB <X> 

MOV X,. .SPBK+. . .SNP 

• ENDC 

. . .SNP = .. .SNP+2 
.ENDM 

CLEF?S . . SPBK+SB . EFN 
BCS LBL2 

SDAT?S #. .SPBK+SB. PMD,#.,.SPBK 
BCS LBL2 

RQST?S #. .SPBK+SB. PMD 
BCC LBL1 
CMP #IE.ACT,@#?DSW 



BEQ LBL1 
SEC 

BR LBL2 
LBL1: WTSE?S 

LBL2: 

•ENDM SNAP? 



, SPBK+SB. EFN 



;Clear event flag 

;Send snap information 

;Request task "PMD..." 

;O.K. if task already 
/active 



;Wait for snapshot to 
; finish 



CIO. 2 SNPBK? Macro 

SNPBK? generates a snap control block. 

.MACRO SNPBK? DEV,UNIT ,CTL ,EFN , ID ,Ll ,Hl ,L2 ,H2 ,L3 ,H3 ,L4 ,H4 
SNPBK? never generates more than one block. 

•IF DF . .SPBK 

•IIF NE <..SPBK-.>, .MEXIT 

• ENDC 
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.MCALL SNPDF$ 
SNPDF$ 

The following code builds the control block. 

. .SPBK:: .WORD CTL ;Control word 

.ASCII /DEV/ ;Send out device name 

.IF NE .-<. .SPBK+SB.DEV+2> 

.ERROR ; Invalid device name "DEV" 

.MEXIT 

• ENDC 

.BYTE UNIT,0 ;Device unit number & unused 

•WORD EFN ; Event flag number 

•WORD ID ; Snapshot identification word 

.WORD LI, Hi ;Dump address limits 

.WORD L2,H2 

.WORD L3,H3 

.WORD L4,H4 

.RAD50 /PMD.../ ;Snapshot task name 

.ENDM SNPBK$ 



C.10.3 SNPDF$ Macro 

SNPDF$ generates snap offset and bit definitions. 

•MACRO SNPDF? GBL 

.IF IDN <GBL>,<DEF$G> 

.GLOBL SB. CTL, SB. DEV, SB. UNT, SB. EFN, SB. ID, SB. LMl , SB. PMD 

.GLOBL SC.HDR,SC.LON,SC.OVL,SC.STK,SC.WRD,SC.BYT 

.ENDC 



C.ll STATE AND KEYWORD TABLE GENERATION MACROS 

These macros initialize table generation - they are called once at the 
start of each finite state machine description. The user must supply 
labels for the state and keyword tables. 



C.ll.l ISTAT$ Macro 

•MACRO ISTAT$ STTBL,KEYTBL 

.MCALL MTRAN$ 

.IF DF $RONLY 

•PSECT $ STATE, D,RO 

• IFF 

.PSECT $STATE,D 

.ENDC 
STTBL: : 

•IF DF $RONLY 

.PSECT $KTAB,D,RO 

.IFF 

.PSECT $KTAB,D 

.ENDC 
KEYTBL: : 

.IF DF $RONLY 

.PSECT $KSTR,D,RO 
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• IFF 
.PSECT 

• ENDC 
$$$KEY 
$$$FLG 
$EXIT ' 
$LAMDA 
$NUMBR 
$STRNG 
$ BLANK 
$SUBXP 
$EOS 
$DNUMB 
$RAD50 
$ANY 
$ALPHA 
$DIGIT 
•PSECT 
.ENDM 



$KSTR,D 

= -1 
= -1 
> 
= 300 

- 302 
= 304 

- 306 
= 310 

- 312 

- 314 

- 316 

- 320 
= 322 

- 324 

ISTAT5 



C.11.2 MTRAN$ Macro 

MTRAN? sends out the last transition entry. 

.MACRO MTRANS 

.PSECT $ STATE 

.IF EQ $$$FLG+1 

$$$FLG = 

.MEXIT 

.ENDC 

$$$TYP 

.BYTE $$$FLG 

.IF NE $$$FLG&1 

$$$EXT 

.ENDC 

•IF NE $$$FLG&2 

$$$ACT 

.ENDC 

.IF NE $$$PLG&10 

$$$BIT 

.ENDC 

.IF NE $$$FLG&4 

.WORD $$$STA 

.IFF 

•IF EQ $$$FLG&200 

•ERROR "BAD DEFAULT TRANSITION" 

. ENDC 
.ENDC 

$$$FLG = 
.ENDM MTRAN$ 
.LIST 



C.11.3 STATE$ Macro 

STATE$ declares a state. 

•MACRO STATE $ LABEL 
•PSECT $STATE 
$$$FLG - $$$FLG!200 
MTRAN? 



C-126 



MACRO EXPANSIONS 



.IP NB LABEL 
LABEL: .ENDC 
$$$FLG = -1 
.PSECT 
.ENDM STATE$ 



C.11.4 TRAN$ Macro 

TRAN$ specifies a state transition. 



.MACRO TRAN$ TYPE , LABEL, ACTION , MASK 


,ADDR 


.PSECT $STATE 




MTRAN$ 




•IF NB ACTION 




$$$FLG = $$$FLG!2 




•MACRO $$$ACT 




.WORD ACTION 




.ENDM $$$ACT 




.ENDC 




.IF NB MASK 




$$$FLG * $$$FLG!30 




.IF B ADDR 




.ERROR "MASK ADDRESS NOT PRESENT" 




.ENDC 




.MACRO $$$BIT 




.WORD MASK, ADDR 




.ENDM $$$BIT 




.ENDC 




.IF NB LABEL 




$$$FLG = $$$FLG!4 




$$$STA = LABEL 




• ENDC 




.IRPC X,<TYPE> 




.IF IDN <X>,<"> 




.PSECT $KSTR 




$$$TMP = . 




.ASCII TYPE<377> 




.PSECT $KTAB 




.WORD $$$TMP 




.MACRO $$$TYP 




.BYTE $$$KEY!200 




•ENDM $$$TYP 




$$$KEY = $$$KEY+1 




.IF GT $$$KEY-63. 




.ERROR "TOO MANY KEYWORDS" 




• ENDC 




.MEXIT 




.ENDC 




.IF IDN <X>,<!> 




$$$FLG = $$$FLG!1 




.MACRO $$$EXT 




.WORD O'TYPE 




.ENDM $$$EXT 




.MACRO $$$TYP 




.BYTE $SUBXP 




.ENDM $$$TYP 




.MEXIT 




.ENDC 




.MACRO $$$TYP 




.BYTE TYPE 




.ENDM $$$TYP 




.MEXIT 
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.ENDM 
.PSECT 
.ENDM TRAN$ 



C.12 SUBMIT FILE TO PRINT SPOOLER (PRT...) MACRO (PRINT$) 



C.12.1 PRINT$ Macro 

The PRINT$ macro takes the following form: 

PRINTS FDB,ERR 

where: 

FDB=Address of the FDB of the file to submit. 
ERR=Address of error routine. 



.MACRO PRINT$ FDB, J 


SRR,? 


.MCALL CALL, CLOSE? 


,LDR0 


LDR0$ FDB 




TST F.BDB(RO) 




BEQ LBL 




MOV R1,-(SP) 




MOV R2,-(SP) 




MOV R3,-(SP) 




MOV SP,R1 




SUB #<8.*2>,SP 




MOV SP,R2 




MOVB F.LUN(RO) ,R3 




GLUN$S R3,R2 




MOV G.LUCW(R2) ,R3 




MOV R0,R2 




ADD #F.FNB+N.DID+6 


,R2 


MOV -(R2) ,-(Rl) 




MOV -(R2) ,-{Rl) 




MOV -(R2) ,-(Rl) 




ADD #N.FID+6-N.DID 


,R2 


MOV -(R2) ,-(Rl) 




MOV -(R2) ,-(Rl) 




MOV -(R2) ,-(Rl) 




CLRB -(Rl) 




ADD #N.FVER+2-N.FID,R2 


MOV -(R2) ,-(SP) 




MOV -(R2) ,-(SP) 




MOV -(R2) ,-(SP) 




MOV -(R2) ,-(SP) 




MOV -(R2) ,-(SP) 




MOV SP,R1 




CLOSE$ RO 




BCS LBL2 




BIT #FD.REC!FD.OSP 


,R3 


BNE LBL2 




MOV R0,R2 




MOV #RPRT,R0 




CALL $DSPAT 




MOV R0,F.ERR(R2) 




MOV R2,R0 




LBL2: ROR Rl 





LBL,A,B,C,D,E,F,?LBL2 
$ ,GLUN$S 

;Load FDB address into RO 

;File open? 

; I f eq no 

;Save Rl and R2 

;Save R3 

;Save pointer to end of send buffer 

;Allocate a get LUN info buffer 

;Save its address in R2 

;Get LUN in R3 

;Get real device name and unit 

;Save characteristics word 1 

;Copy FDB address 

;Point to end of directory ID 

;Push directory ID 



;Point to end of file ID 
;Push file ID 



;Clear LUN information flags byte 
; Point to end of filename, type, 

; version 
;Push file version number 
;Push file type 
;Push filename 



;Set pointer to send buffer 
;Close file 
;Skip on error 

/•Record oriented or spooled device? 
;If ne yes 
;Save FDB address 
?Get "PRT" in RAD-50 
;Send data to ...PRT or PRT... 
;Get return status 
; Restore FDB address 
;Save carry 
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ADD #<13.*2>,SP 
ROL Rl 

MOV (SP)+,R3 
MOV (SP)+,R2 
MOV (SP)+,Rl 
•IF NB ERR 
BCC LBL 
CALL ERR 
.ENDC 
LBL: 

.ENDM PRINT? 



;Clean stack 
;Restore carry 

j Restore R3 
; Restore Rl and R2 



;If CC okay 

;Call error routine 



; Reference label 



C.13 SET/GET SYMBOL (TTSYM$) MACRO EXPANSIONS 



C.13.1 TTSYM$ Macro 

The TTSYM$ macro file is used by RSX-llD, IAS, and RSX-llM terminal 
drivers. However, the RSX-llM terminal driver uses only a limited 
number of the symbols in this file. The TTSYM$ macro defines all the 
symbols required for terminal SET and GET characteristics. 

MACRO TTSYM$ $$$GBL 

MCALL DEFIN$ 

. .GBL=0 

IF IDN,<$$$GBL>,<DEF$G> 

. .GBL=1 

ENDC 



DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 

DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 



TC.WID,1 

TC.LPP,2 

TC.RSP,3 

TC.XSP,4 

TC . STB , 5 

TC.ISL,6 

TC . RAT , 7 

TC.TTP,8 

TC.SCR,9 

TC.SCP,10 

TC.HFL,11 

TC.VFL,12 

TC.NL ,13 

TCSFF,14 

TC.HFF,15 

TC.LVF,16 

TC.HHT,17 

TC.NST,18 

TC.BSP,19 

TC.ACR,20 

TC.SMR,21 

TC.SMP,22 



TC.SMO,23. 
TC.CCF,24, 
TC . ALT ,25, 
TC.IMG,26 
TC.NKB,27 . 
TC.NPR,28 
TC.ESQ,29. 
TC.LCP,30. 



Line width 

Lines per page 

Receiver speed 

Transmitter speed 

Two stop bits 

Subline on interface 

Read-ahead type 

Terminal type 

Script line 

Scope 

Horizontal fill requirement 

Vertical fill 

ASCII newline terminal 

Simulate formfeed and vertab 

HARDWARE FORMFEED AND VERTAB 

LA36 vertical fill 

Hardware horizontal tab 

Non-standard hardware tab 

Hardware backspace 

Automatic carriage return required 

Small character input enabled 

Small character input required 
; (/lower case input) 
; Small character output enabled 
;CONTROL-C flushes type-ahead and read 
Alternative ALTMODE recognition 
; IAS - messages inhibited 
;No keyboard 
;No printer 

; Escape sequence recognition 
; Local copy line 
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DEFIN$ TC.PAR,31, 



DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN? 
DEFIN? 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 



TC.EPA,32. 
TC.DLU,33. 
TC.BLK,34. 
TC.FRM,35. 
TC.HLD,36. 
TC.TAP,37. 
TC.CEQ,38. 
TC.NEC39. 
TC.SLV,40. 
TC.PRI,41. 
TC.UC0,42. 
TC.UC1,43. 
TC.UC2,44. 
TC.UC3,45. 
TC.UC4,46. 
TC.UC5,47. 
TC.UC6,48. 
TC.UC7,49. 
TC.UC8,50. 
TC.UC9,51. 
TC.MAX,52. 



MACRO EXPANSIONS 



Parity recognition/generation 
; required 

Even parity 

Dialup line 

Block mode terminal 

Forms mode terminal 

Terminal hold mode 

Low speed paper tape reader 
compatible escape sequences 
terminal in no-echo mode 
terminal in slave mode 
terminal is privileged 

User characteristic 

User characteristic 1 

User characteristic 2 

User characteristic 3 

User characteristic 4 

User characteristic 5 

User characteristic 6 

User characteristic 7 

User characteristic 8 

User characteristic 9 

This must be one greater 
than the highest value used 
for a symbol 



Set Characteristic Error Codes 



DEFIN? SE.ICN,1. 
DEFIN? SE.FIX,2. 

DEFIN? SE.BIN,3. 

DEFIN? SE.VAL,4. 

DEFIN$ SE.TER,5. 
DEFIN$ SE.SPD,6. 
DEFIN? SE.SPL,7. 
DEFIN$ SE.PAR,8. 
DEFIN? SE.LPR,9. 
DEFIN$ SE.NSC,10. 

DEFIN$ SE.UPN,11, 

DEFIN? SE.NIH,12, 



Wrong characteristic name 
Attempt to change fixed 

characteristic 
Wrong value for binary 

characteristic 
Wrong value for non-binary 

characteristic 
Wrong terminal type 
Wrong speed for interface 
Wrong split speed for interface 
Wrong parity type for interface 
Other wrong line parameters 
Interface does not have settable 

characteristics 
No space to save default 

characteristics 
Characteristic not assembled in 

handler 



Subfunction Codes for the Set Characteristics Function 



DEFIN$ 
DEFIN? 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN? 



SF.SSC, 
SF.SMC, 
SF.RDF, 
SF.STT, 
SF.STS, 
SF.GSC, 
SF.GMC, 
SF.GAC, 
SF.SAC, 
SF.DEF, 



2400 
2400 
2400 
2400 
2400 
2400 
2400 
2400 
2400 
010 



1020 
1040 
1060 
!100 
1120 
1140 
!160 
1200 
!220 



Set single 
Set multipl 
Restore def 
Set termina 
Set termina 
Get single 
Get multipl 
Get all cha 
Set all cha 
Set default 



characteristic 
e characteristics 
ault 
1 type 

1 type and speed 
characteristic 
e characteristics 
racteristics 
racteristics 
characteristics 



Speed Types 



DEFIN? S.O 
DEFIN? S.50 



,1. 
,2. 
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DEFIN? 
DEFIN? 
DEFIN? 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN? 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 
DEFIN? 



,3. 
,4. 
,5. 
,6. 

,7. 
,8. 
,9. 
,10, 



S.75 

S.100 

5.110 

S.134 

S.150 

S.200 

S.300 

S.600 

S. 1200, 11. 

S. 1800, 12. 

S. 2000, 13, 

S. 2400, 14, 

5. 3600. 15, 

5. 4800. 16, 
S. 7200, 17, 
S. 9600, 18, 
S.EXTA,19 
S.EXTB,20 



Terminal Types 

DEFIN? T.UNK0,0. 
DEFIN$ T.AS33,1. 
DEFIN$ T.KS33,2. 
DEFIN$ T.AS35,3. 
DEFIN$ T.L30S,4. 
DEFIN$ T.L30P,5. 
DEFIN$ T.LA36,6. 
DEFIN$ T.VT05,7. 
DEFIN? T.VT50,8. 
DEFIN$ T.VT52,9. 
DEFIN$ T.VT55,10, 
DEFIN$ T.VT61,11. 
DEFIN? T.L180,12. 
DEFIN$ T.SCR0,13. 
DEFIN? T.USR0,14. 
DEFIN$ T.USR1,T.USR0+1 
DEFIN$ T.USR2,T.USRl+l 
DEFIN$ T.USR3,T.USR2+1 
DEFIN$ T.USR4,T.USR3+1 



Unknown (unspecified) 

ASR33 

KSR33 

ASR35 

LA30S 

LA30P 

LA36 

VT05 

VT50 

VT52 

VT55 

VT61 

LA180S 

Script line 

User terminal 

User terminal 1 

User terminal 2 

User terminal 3 

User terminal 4 



Bits for Return from 'GET TERMINAL SUPPORT' 



DEFIN? Fl.ACR, 000001 
DEFIN$ Fl.BTW, 000002 
DEFIN$ Fl.BUF, 000004 
DEFIN$ Fl.UIA, 000010 
DEFIN? Fl. CCO, 000020 
DEFIN$ Fl. ESQ, 000040 
DEFIN? Fl.HLD, 000100 
DEFIN? Fl.LWC, 000200 
DEFIN? Fl.RNE, 000400 
DEFIN? Fl. RPR, 001000 
DEFIN? Fl.RST, 002000 
DEFIN? Fl. RUB, 004000 
DEFIN? Fl.SYN, 010000 
DEFIN? Fl. TRW, 020000 
DEFIN? Fl.UTB, 040000 
DEFIN? Fl.VBF, 100000 
DEFIN? F2.SCH, 000001 
DEFIN? F2.GCH, 000002 
DEFIN? F2.DCH, 000004 



Auto CR/LF on long lines 

Break through write 

Intermediate buffering 

Unsolicited input ASTs 

Cancel CONTROL-0 on write 

Escape sequence support 

Hold screen support 

Lower case conversion 

Read no echo 

Read with prompt 

Read with special terminators 

Scope rubouts 

XON/XOFF 

Transparent read/write 

Buffering in task buffer 

EXEC buffers are variable length 

Set characteristics 

Get characteristics 

Dump/restore characteristics 
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DEFIN$ F2.DKL, 000010 
DEFIN$ F2. ALT, 000020 
DEFIN? F2.SFF, 000040 



MACRO EXPANSIONS 



.•Historical 11D/IAS IO.KIL 

;ALTMODE is echoed 

; Formfeed can be simulated 



Subfunction Bits for Terminal Handler QIOs. 

Note: A complete list of terminal handler function and subfunction 

codes appears in this appendix under QIOMAC. 



DEFIN$ TF.RST,001 

DEFIN$ TF. BIN, 002 
DEFIN$ TF.RAL,010 
DEFIN$ TF.RNE,020 
DEFIN$ TF.RNC,040 



DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN$ 
DEFIN? 



TF.XOF,100 
TF.TMO,200 
TF.WAL,010 
TF.WMS,020 
TF.CCO,040 
TF.WBT,100 
TF.SYN,200 
TF. AST, 010 
TF. ESQ, 020 



.MACRO TTSYM? A 

. ENDM 

.ENDM TTSYM$ 



[IO.RLB/IO.RPR] Read with special 
terminators 

Send prompt as PASS ALL 
Read pass all 
Read with no echo 
Read with no case 
conversion 

Send XOF after prompt 
Read with timeout 
[IO.WLB] Write pass all 

Write suppressible message 

Cancel CONTROL-0 

Break through read 

Synchronous write 
[IO. ATT] Specify ASTs in attach 

Recognise escape sequences 
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D.l LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 

The following is a listing of all the conditional assembly parameters 
that are possible on the RSX-11M system. Many of these may not apply 
to your system but are listed here for your convenience. 



Parameter 

A$$CHK 

A$$CPS 

A$$D01 

A$$F11 

A$$NSI 

A$$PRI 

A$$R11 

A$$RDA 

A$$TRP 

B$$OOT 

C$$CKP 

C$$INT 

C$$LIS 

C$$ORE 

C$$OVL 

C$$R11 

C$$RSH 

C$$RUN 

D$$B11 

D$$BUG 

D$$E11 

D$$H11 

D$$IAG 

D$$ISK 

D$$J11 

D$$L11 

D$$M11 

D$$P11 

D$$Q11 

D$$SHF 

D$$U11 

D$$W11 

D$$YNC 

D$$YNM 

D$$211 

D$$ZMD 

E$$DVC 

E$$EAE 

E$$NSI 

E$$PER 



Definition 



Address checking 

ACP support 

AD01-D A/D convertors 

AFC11 A/D convertors 

ANSI magtape support 

ALTER PRIORITY directive 

ARll laboratory peripheral systems 

ARll D/A option 

AST support 

Bootstrap ROM address 

Checkpointing support 

Connect interrupt vector support 

Command language interpreter support 

Size of dynamic storage region 

Overlaid network ACP 

CRll card readers 

Crash reporting 

Crash unit number 

DA11-B parallel line interfaces 

Panic dump routine 

DL11-E line interfaces 

DHll asynchronous line multiplexers 

User mode diagnostics 

Nonresident task support 

DJ11 asynchronous line multiplexers 

DL11/A/B/C/D line interfaces 

DM11BB modem control interfaces 

DP11 line interfaces 

DQ11 synchronous line interfaces 

Automatic dynamic memory compaction 

DUll line interfaces 

DUPll line interfaces 

Dynamic checkpoint allocation 

Dynamic memory allocation support 

DZll asynchronous line multiplexers 

DZll modem support 

Log device errors and timeout 

EAE support 

Log undefined interrupts 

Log parity error traps 
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Parameter 



Definition 



E$$XPR 

F$$AST 

F$$LPP 

F$$LTP 

F$$LVL 

G$$TPP 

G$$TSS 

G$$TTK 

G$$WRD 

I$$C11 

I$$CAD 

I$$CDA 

I$$CDS 

I$$CIM 

I$$CLK 

I$$CLT 

I$$CR 

I$$CRS 

I$$CSS 

I$$CTI 

I$$CWD 

I$$G11 

I$$RAR 

I$$RDN 

I$$S11 

I$$SDR 

I$$SDS 

I$$SLK 

I$$SPW 

I$$SRC 

I$$SSC 

K$$CNT 

K$$CSR 

K$$G11 

K$$LDC 

K$$TPS 

K$$W11 

L$$11R 

L$$50H 

L$$ASG 

L$$DRV 

L$$P11 

L$$PS1 

L$$SBF 

L$$SDA 

L$$SDR 

L$$SGR 

L$$SIl 

LD$AD 

LD$AF 

LD$AR 

LD$CR 

LD$CT 

LD$DB 

LD$DF 

LD$DK 

LD$DM 

LD$DP 

LD$DS 

LD$DT 

LD$DX 

LD$LP 



EXTEND PARTITION (task) directive 

Asynchronous FPP 

Floating point processor support 

FIS support 

File structure level support 

GET PARTITION PARAMETERS directive 

GET SENSE SWITCHES directive 

GET TASK PARAMETERS directive 

Include $GTWRD code 

ICS/ICR-11 industrial control subsystems 

ICS/ICR-11 A/D convertor modules 

ICS/ICR-11 D/A modules 

ICS/ICR-11 digital sense input modules 

ICS/ICR-11 digital interrupt modules 

ICS/ICR-11 task activation from interrupts 

ICS/ICR-11 bi-stable output modules 

ICR-11 remote units 

ICS/ICR-11 status recovery 

ICS/ICR-11 single shot output modules 

ICS/ICR-11 I/O counter modules 

ICS/ICR-11 error count 

KG11 CRC option 

Install, request, and remove on exit 

I/O rundown 

DRS/DSS-11 input/output modules 

DRS-11 output modules 

DSS-11 input modules 

Task activation from interrupts 

DRS-11 status restore on power recovery 

DRS-11 command register address 

DSS-11 command register address 

Count register address 

Programmable clock CSR address 

KG11 CRC option 

Load count value 

Ticks per second 

KW11-Y support 

Fast printer support 

50HZ line frequency 

Logical device assignment support 

Loadable driver support 

LP/LS/LV11/LA180 line printers 

LPS11 laboratory peripheral systems 

LPS11 bandwidth filtering 

LPS11 D/A option 

LPSDR-A present 

LPS11 gain ranging option 

LSI-11 processor 

Loadable ADDRV 

Loadable AFDRV 

Loadable ARDRV 

Loadable CRDRV 

Loadable CTDRV 

Loadable DBDRV 

Loadable DFDRV 

Loadable DKDRV 

Loadable DMDRV 

Loadable DPDRV 

Loadable DSDRV 

Loadable DTDRV 

Loadable DXDRV 

Loadable LPDRV 
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Parameter 



Definition 



LD$LS 

LD$MM 

LD$MT 

LD$PP 

LD$PR 

LD$TT 

LD$XB 

LD$XL 

LD$XM 

LD$XP 

LD$XQ 

LD$XU 

LD$XW 

M$$CRX 

M$$CRB 

M$$EXT 

M$$FCS 

M$$IXD 

M$$MGE 

M$$MUP 

M$$NET 

M$$OVR 

N$$CON 

N$$MOV 

N$$MXM 

N$$TMO 

P$$D70 

P$$GMX 

P$$LAS 

P$$P11 

P$$P45 

P$$R11 

P$$RFL 

P$$RTY 

P$$SRF 

P$$TPT 

P$$WRD 

Q$$CRC 

Q$$HPT 

Q$$OPT 

R$$11S 

R$$11M 

R$$611 

R$$60F 

R$$6WC 

R$$DER 

R$$EXV 

R$$F11 

R$$JPO 

R$$JS1 

R$$JP1 

R$$K11 

R$$KWC 

R$$LOD 

R$$NDC 

R$$LKL 

R$$NDH 

R$$NDL 

R$$P11 

R$$SND 

R$$X11 

S$$ECC 



Loadable LSDRV 

Loadable MMDRV 

Loadable MTDRV 

Loadable PPDRV 

Loadable PRDRV 

Loadable TTDRV 

Loadable XBDRV 

Loadable XLDRV 

Loadable XMDRV 

Loadable XPDRV 

Loadable XQDRV 

Loadable XUDRV 

Loadable XWDRV 

External MCR functions 

MCR command buffer length 

11/70 extended memory support 

FCS/file system support 

Mixed RH11 drive types 

Memory management 

Multi-user protection 

Network ACP support 

Overlayed MCR 

Number of simultaneous logical channels 

Size of BLXIO "MOV table 

Maximum network data message size 

Network control message timeout period 

11/70 cache parity support 
Get mapping context 

Program logical address extensions 

PC11 paper tape punch 

Rotating data lights 

PRll paper tape reader 

Powerfail recovery 

Parity memory 

SEND/RECEIVE by REFERENCE 

Point-to-point network support 

Include $PTWRD code 

DQ11 CRC option support 

DQ11 protocol option support 

Pre-allocate I/O packets 

RSX-11S system 

RSX-11M system 

RK611 disk cartridge controllers 

RK06 offset recovery support 

RK611 write check support 

CORAL deallocation error checking 

Extend Executive to 20k 

RFll fixed head disk controllers 

Offset recovery support 

RJ/RWS03-04 fixed head disk controllers 

RJ/RWP04-05-06 disk pack controllers 

RKll cartridge disk controllers 

RKll write check support 

Remote task loading 

Clock ticks per scheduling interval 

RMS-11 block locking 

Highest priority class to consider 

Lowest priority class 

RP11-C/E disk pack controllers 

SEND/RECEIVE directives 

RXll disk controllers 

Shared Executive ECC code 
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Parameter 



Definition 



S$$WPC 
S$$WPR 
S$$WRG 
S$$YSZ 
T$$18S 
T$$30P 
T$$All 
T$$ACR 
T$$BTW 
T$$BUF 
T$$Cll 
T$$CCA 
T$$CCO 
T$$CTR 
T$$ESC 
T$$GMC 
T$$GTS 
T$$HLD 
T$$J16 
T$$KMG 
T$$LWC 
T$$M11 
T$$MAN 
T$$MIN 
T$$RNE 
T$$RPR 
T$$RST 
T$$RUB 
T$$SMC 
T$$SYN 
T$$TRW 
T$$UTB 
T$$VBF 
T$$ZAN 
U$$ACH 
U$$ADM 
U$$AOM 
U$$CIM 
U$$CSM 
U$$D11 
U$$LTM 
U$$MHI 
U$$MLO 
U$$MRN 
U$$NIP 
U$$SSM 
U$$TIM 
V$$CTR 
V$$S2S 
V?$S60 
V$$T11 
X$$DBT 
X$$M11 



Clock ticks per swapping interval 

Swapping priority 

Console switch register present 

Size of physical memory in 32W blocks 

LA180S support 

LA30P support 

TA11 dual cassettes 

Automatic CR/LF 

Breakthrough write 

Terminal input checkpointing 

TC11 DECtape controllers 

Unsolicited input AST 

Write with control-0 cancellation 

Control-R support 

Escape sequence support 

Get terminal characteristics 

Get terminal driver support 

Hold-screen support 

TJ/TWU16--45 magtape controllers" 

Task termination/device not ready messages 

Settable case conversion (lower case) 

TM/TMA/TMB11 magtape controllers 

DM11BB answer baud rate 

Baseline terminal driver 

Read with no echo 

Read with prompt or after prompt 

Read with special terminator 

CRT rubout 

Set terminal characteristics 

Terminal-host synchronization support 

Transparent terminal read/write 

User terminal input buffering 

Variable length terminal input buffers 

DZll answer baud rate 

Number of channels per module 

ADU01 or IAD-IA module description 

Analog output modules 

Digital interrupt module description 

Digital sense intput module 

UDC11 Universal digital controller 

Bi-stable output module description 

High part of UNIBUS address 

Low part of UNIBUS address 

Address of next available UMR 

Uni-polar A/D sampling 

Single-shot output modules 

I/O counter module description 

Address of highest vector plus 4 

VS60 drives two CRT monitors 

VS60 graphics display subsystem 

VTll graphics display subsystem 

Executive debugging tool 

DMC11 line interfaces 
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APPENDIX E 
GENERAL FAULT ISOLATION 



E . 1 INTRODUCTION 

This Appendix is a guide containing some general hints about fault 
isolation in the RSX-llM system. It is not an all-inclusive guide, 
but it does offer suggestions to get you started in the right 
direction. Other aids that may help you: 

• RSX-llM Crash Dump Analyzer Manual 

• IAS/RSX-11 OPT Reference Manual (for the Online Debugging 
Tool) 

• RSX-llM User Mode Diagnostics Reference Manual 

• Executive Debug Tool (XDT) and Panic Dump, described in the 
RSX-llM Guide to Writing an I/O Driver 

• RSX-llM Task Builder Reference Manual (for Post Mortem and 
Snapshot Dumps) 



E.2 FAULT CLASSIFICATIONS 

Four possible causes can be identified when the system faults: 

1. A user-state task has faulted such that it causes the system 
to fault (unmapped systems only) 

2. A user-written driver has faulted such that it causes the 
system to fault 

3. The RSX-llM system software itself has faulted 

4. The host hardware has faulted. 

You should immediately determine which of these four cases is the 

source of the fault. This section outlines the procedures that may 

help you to uncover the source of the fault. Correcting the fault is 
assumed to be your responsibility. 



E.3 SERVICING FAULTS 

Faults manifest themselves in roughly four ways. They are listed here 
in the order of increasing difficulty of isolation. 
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1. If XDT is included in your system, an unintended trap to XDT 
occurs. 

2. The system displays text indicating a crash has occurred and 
halts. 

3. The system halts but displays nothing. 

4. The system is in an unintended loop. 

Regardless of fault manifestation, you should immediately obtain 
pertinent fault isolation data. 

Case 1- — The system has trapped to XDT 

The trap may or may not be intended (for example, you may not have 
removed a previously set breakpoint). If the trap is not intended, 
type the X command. This causes XDT to jump to location 40(8), from 
which the Executive stack and register dump routine (if present), 
followed by either Panic Dump or the Crash Dump Analyzer (CDA) support 
routine (if present), will be invoked. If, however , you have some 
idea of the source of the problem (for example, a recent coding 
change) , then you can use XDT to examine pertinent data structures and 
code. 

Case 2 - The system has displayed text indicating a crash occurred 

If the text consists of output from the Executive stack and register 
dump routine, all the basic information describing the state of the 
system has been displayed. If the text has been produced by the CDA 
support routine, follow the procedure for obtaining and formatting a 
memory dump as outlined in the RSX-llM Crash Dump Analyzer Reference 
Manual . " ""* 

Case 3 — The system has halted but displays no information 

Before taking any action, examine and record the following 
information: 

• Current PS and PC 

• General registers 

• Executive stackpointer and stack 

• Executive PARs on a mapped system 

• Pertinent device registers 

The procedure depends on the particular PDP-11 processor. Consult the 
appropriate PDP-11 Processor Handbook for details. 

After preserving the PS and PC, invoke your resident debugging aid: 
enter 40(8) in the switch register, press LOAD ADDR, and then press 
START. The contents of 40(8) cause the successive invocation of: 

1. The Executive stack and register dump routine (if present) 

2, Either Panic Dump or CDA support routine (if present) 
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Case 4 - System is in an unintended loop 
Proceed as follows: 

1. Halt the processor 

2. Record PC and PS and any pertinent device registers, as in 
Case 3 above. 

You may then want to step through a number of instructions in an 
attempt to locate the loop. For this attempt to be meaningful you 
must first disable the system clock. Proceed as follows: 

1. Examine the contents of word 777546 (if your system has a 
line frequency clock) or word 772540 (if it has a 
programmable clock) . 

2. Clear bit 6 in this word and redeposit the word. This 
disables the clock. 

3. The system will not run unless you reenable the clock. 

4. After trying to locate the loop and reenabling the clock, 
transfer to location 40(8) as in Case 3. 



E.3.1 Gathering Pertinent Fault Isolation Data 

Before proceeding with locating the fault, you should to dump the 
system common (SYSCM) . SYSCM contains a number of critical pointers 
and listheads. Find the file SYSCM in the Executive memory allocation 
map listing, then enter the appropriate limits into the Panic Dump 
Routine. 

Alternately, you can run the Crash Dump Analyzer as a task; or, if 
XDT is included in your system and a program condition causes a 
processor trap, control transfers automatically to XDT and typing X at 
your terminal causes control to be transfered to the crash dump 
routine. 

In addition, you should to dump the Dynamic Storage Region and the 
device tables. The Dynamic Storage Region starts in the module INITL 
and the device tables are in SYSTB. 

At this point, you have the following data: 

• PS 

• PC 

• The stack 

• R0 through R6 
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• The Dynamic Storage Region 

• The Device Tables 

• System common 

These data are the minimum required to trace the fault effectively. 



E.3.2 Tracing Faults 

Three pointers in SYSCM are critical in fault tracing. These pointers 
are described below: 

$STKDP - Stack Depth Indicator 

This data item indicates which stack was being used at the time 
of the crash. $STKDP plays an important role in determining the 
origin of a fault. The following values apply. 

+1 — User (task-state) stack 
— System stack (system processing) 

-1 — Interrupt processing only 

$TKTCB - Pointer to the Current Task Control Block (TCB) 

The current TCB is the TCB of the user-level task in control of 
the CPU. 

$HEADR - Pointer to the Current Task Header 

The ?HEADR word points to the header of the task currently 
running. The task header provides additional data to help 
isolate the fault. Figures E-l and E-2 show the layout of task 
headers for unmapped and mapped systems. 

The first word in the header is the user task's stack pointer 
(SP) the last time it was saved. If the user task branches 
wildly into the Executive, the Executive terminates the user 
task, but the system continues to function (possibly erroneously 
on an unmapped system) . On a mapped system, only a privileged 
task can enter and corrupt the Executive. Knowing the user 
task's stack pointer provides one more link in the chain that may 
lead to the resolution of the fault. 

The header (as pointed to by $HEADR) also contains the last-saved 
register set, just before the header guard word (the last word in 
the header, pointed to by H.GARD). 
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RO 



R1 



R2 



R3 



H.NLUN 
H.GARD 



H.HDLN 



LENGTH IN BYTES 



SP 



PS 



PC 



R5 



R4 



Figure E-l Task Header on an Unmapped System 
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Figure E-2 Task Header on a Mapped System 



B.3.2.1 Tracing Faults Using a Display of the Executive Stack and 
Registers - To trace a fault after a display of the Executive stack 
and register contents, first examine the system stack pointer. 
Usually an Executive failure is the result of an SST-type trap within 
the Executive. If an SST does occur within the Executive, the origin 
to the call on the crash reporting routine is in the SST service 
module. (The crash call is initiated by issuing an IOT at a stack 
depth of zero or less.) 
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A call ho crash also occurs in the Directive Dispatcher when an EMT is 
issued at a stack depth of zero or less, or a trap instruction is 
executed at a depth of less than zero. The stack structure in the 
case of an internal SST fault is shown in Figure E-3. 



PS 



PC 



RB 



R4 



R3 



R2 



R1 



RO 



RETURN TO SYSTEM EXIT 



ZERO OR MORE SST PARAMETERS 



SST FAULT CODE 



NUMBER OF BYTES 



SP 



Figure E-3 Stack Structure: Internal SST Fault 



The fault codes are: 

Odd address and traps to 4 

2 Memory protect violation 

4 Break point or trace trap 

6 IOT instruction 

10 Illegal or reserved instruction 

12 Non-RSX EMT instruction 

14 Trap instruction 

16 11/40 floating point exception 

20 SST abort - bad stack 

22 AST abort - bad stack 

24 Abort via directive 

26 Task load read failure 

30 Task checkpoint read failure 

32 Task exit with outstanding I/O 

34 Task memory parity error 

The PC points to the instruction following the one which caused the 
SST failure. The number of bytes is the number normally transferred 
to the user task's stack when the particular type of SST occurs. If 
the number is 4, an abnormal SST fault occurred, and only the PS and 
PC are transferred. There are no SST parameters. 

If the failure is detected in $DRDSP the stack is the same as that 
shown in Figure E-3, except the number of bytes, the SST fault code 
(the fault codes are listed above), and the SST parameters are not 
present. The crash report message, however, will indicate that the 
failure occurred in $DRDSP. 
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One SST-type failure, stack underflow, does not result in the stack 
structure of Figure E-3. To determine where the crash occurred, first 
establish the stack structure; this can be deduced by the value ot 
the SP and the contents of the top word on the stack. If the stack 
structure is that of Figure E-3, then the failure occurred in ?DRDSP, 
or was a normal SST crash. If the stack structure is that of Figure 
E-4, then an abnormal SST crash has occurred. 



SP 



PS 



PC 



Figure E-4 Stack Structure: Abnormal SST Fault 

Abnormal SST failures occur when it is not possible to push 
information on the stack without forcing another SST fault. When this 
situation occurs, a direct jump to the crash reporting routine occurs 
rather than an IOT crash. The PS and PC on the stack are those of the 
actual crash, and the address printed out by the crash-reporting 
routine is the address of the fault rather than the address of the IOT 
that crashes the system. Note that the crash reporting routine 
removes the PC and PS of the IOT instruction from the stack, which in 
this case is incorrect. Thus, the SP appears to be 4 bytes greater 
than it really is (as in Figure E-4) . 

You now have all the information needed to isolate the cause of the 
failure. 

E.3.2.2 Tracing Faults When the Processor Halts Without Display - To 
trace a fault when the processor halts but displays no information 
(Case 3 as described above), first examine $STKDP, $TKTCB, and $HEADR. 
Tracing failures in this case is difficult because the system stack is 
not directly associated with the cause of a failure. 

By examining $STKDP, you can determine the system state at the time of 
the failure. If the system was in user state, examine the user task s 
stack. The examination focuses on scanning the stack for addresses 
that may be subroutine links that can ultimately lead to a thread of 
events isolating the fault. This is essentially the aim of looking at 
the system stack if $STKDP is zero or less. 

Frequently, a fault can occur that causes the SP to point to the Top 
of Stack (T0S)+4. This fault results from issuing an RTI when the top 
two items on the stack are data instead of the return address (PC) and 
processor status (PS) for the routine being returned to. A wild 
branch occurs followed, most probably, by a halt. 

Figure E-5 shows a case in which two data items are on the stack when 
the program executes an RTI. TOS points to a word containing 40100. 
This word will be the new PC. Suppose that location 40100 contains a 
halt After the RTI and the halt occurs, the SP points four bytes 
above the previous location, and fault tracing should begin from the 
previous SP. 



E-7 



GENERAL FAULT ISOLATION 



40100 



SP 
AFTER RT! 
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BEFORE 
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Figure E-5 Stack Structure: Data Items on Stack 

This type of fault also occurs when an RTS instruction is executed 
with an inconsistent stack; that is, a stack with the wrong contents 
for the correct execution of the RTS instruction.' The RTS instruction 
pops the top element off the stack. The top element of the stack 
becomes the new PC or occupies a register depending on the form of the 
RTS instruction. However, in any case, SP points to TOS+2 after an 
RTS instruction. 

A scan of the contents of the general registers may give some hint as 
to the neighborhood in which a fault (or the sequence of events 
leading up to the fault) occurred. 

If the fault occurred in a new driver, the buffer address and count 
words in the UCB (U.BUF, U.BUF+2, U.CNT), and the activity flags 
(US.BSY and S.STS) are frequent sources of clues. Other locations in 
both the UCB and SCB may also provide information that may help locate 
the source of the fault. 



E.3.2.3 Tracing Faults After an Unintended Loop - To trace a fault 
when an unintended loop has occurred, first halt the processor. After 
you halt the processor, the same state exists as in tracing faults 
when the processor halts without display (as described above) . Follow 
the same tracing procedure described there. A specific suggestion is 
to check for a stack overflow loop. Patterns of data successively 
duplicated on the stack indicate a looping failure. 



E.3.2.4 Additional Hints for Tracing Faults 



E.3.2.5 I/O Packets - Another item to check is the current (or last) 

I/O packet, the address of which is found in S.PKT of the SCB. The 

packet function (I.FCN) defines the last activity performed on the 
unit. 



If trouble occurred in termin 
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in SYSCM. Because all I/O 
Storage Region, their memory 
when they are successfully te 
this region may reveal whethe 
In systems with QIO optimiz 
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ating an I/O request, a scan of the free 
Dynamic Storage Region may provide some 
the address contained in $CRAVL, a cell 
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r I/O completion proceeded to that point, 
ation, $PKAVL (SYSCM) points to a list of 
namic memory that are not linked into the 
last completed I/O packet is the first in 
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A frequent error for an interrupt-driven device is to terminate an I/O 
packet twice when the device is not Properly disabled on I/O 
completion and an unexpected interrupt occurs. This action ultimately 
produces a double deallocation of the same packet of dynamic memory. 
Double deallocation of a dynamic buffer in RSX-11M causes a 
the routine $DEACB (in the CORAL module) on the next deallocation (ol 
a block of higher address) after the second deallocation of the same 
block. At that time, R2 and R3 both contain the address of the I/O 
packet memory that has been doubly deallocated. If XDT has been 
included in the system, the deallocation " utl "* che ^! t f "^ 
deallocation and crashes the system if it occurs. Note, that queue 
I/O optimization, which employs pre-allocated I/O packets, may cause a 
double-deallocation error to get by. This may happen if the I/O 
packet in question does not become deallocated and is put in a 
Separate list" To avoid this, use the SET /MAXPKT-0 command to 
temporarily void the optimization. 

E.3.2.6 System Stack Pointer - Use the system stack pointer to find 
the current position of the system stack. The system stack will 
contain addresses or instructions of code that .was being executed 
p?io? to the crash (this is only true if the $STKDP is less than 1). 
From this point, all call activity can be traced, with the help of the 
listings, back to the original $SWSTK or EMT377 call. 
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SYSTEM TONING 



This appendix is a brief synopsis of ways to improve the performance 
of an RSX-11M system. There may be many conflicting trade-offs and 
requirements in your particular installation; therefore, some 
techniques may not be applicable to your situation. This appendix is 
not intended to be the last word in system tuning, but is written in 
the nature of a general approach to system tuning and contains some of 
the techniques and concepts you can use to improve performance. 



F.l HARDWARE CONSIDERATIONS 

The most obvious approach to improving system performance is to 
upgrade the hardware to faster and/or larger capacity devices. If 
your applications make heavy demands upon CPU time, it makes sense to 
upgrade to a faster processor. If your application involves many disk 
transfers, more CPU memory may be needed to reduce the number of 
transfers or fixed head disks may be needed to reduce transfer time. 
Heavily overlaid tasks require many disk transfers. If this 
constantly occurs, more memory may allow fewer task overlays. The use 
of memory management directives instead of overlaid tasks could 
improve system performance in this case. Also, consider the use of 
resident overlays or multiple copies of F11ACP, one for each volume, 
if you must use overlaid tasks with high I/O requirements. However, 
resident overlays require more memory. 



F.2 MEMORY LAYOUT 

The memory layout of your particular system is an important factor 
that affects system throughput. The following procedures improve 
throughput: 

• If your CPU has enough memory, put the following system 
programs in separate partitions to avoid their checkpointing 
each other: 

MCR, F11ACP, TKTN, SHUFFLER 

• Load loadable drivers into special driver partitions to avoid 
fragmenting memory. 

• Arrange to have PLAS dynamic regions in their own special 
partitions. 
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F.3 EXECUTIVE SOFTWARE OPTIONS 

The options listed below are covered in detail in the RSX-llM System 
Generation Manual . The most important options that affect system 
performance include: 

• Choice of FllACP - If your memory is big enough, install 
BIGFCP as memory-resident to greatly improve disk access time. 
Install separate copies of FllACP for each disk if file access 
is frequent and occurs to many different disks. . The /ACP 
switch in the Mount command selects the copy of FllACP for 
that particular disk. 

• Dynamic checkpoint allocation on the fastest system disk on 
your system. 

• Shuffling - The Shuffler, a nonresident privileged task for 
mapped systems compacts memory in a system-controlled 
partition. This task minimizes memory fragmentation and 
provides better memory usage. The Shuffler is a SYSGEN 
option. 

• Round-robin scheduling - Selection of the round-robin 
scheduling option during SYSGEN ensures that tasks in a range 
of priorities share the use of memory. This is important when 
many CPU-bound tasks within a specified range of priorities 
are running at the same time. 

• Swapping - This SYSGEN option allows tasks to be checkpointed 
by tasks of equal priority when many tasks of equal priority 
are competing for memory. The checkpointing option is a 
pre-requisite. 

• Memory management directives - Allows tasks to access a 
greater span of physical memory than their normal 32K 
addressing capability allows. 

• Loadable device drivers - Loadable drivers may slow down I/O a 
bit, however, they occupy memory only when needed. 

• Queue I/O speed optimizations - I/O throughput is increased at 
the expense of additional Executive code. Because of this 
option, I/O packets are pre-allocated, which makes them 
quickly available for QIOs. 

• Install, request, and remove on exit support - This option 
conserves Dynamic Storage Region space by allowing tasks to be 
memory resident only when active, but does not increase 
throughput. 

• Checkpointing on terminal input - This SYSGEN option allows 
more copies of terminal I/O-bound tasks to be run than 
normally could be run in a given amount of memory. 

• Error logging - This option can be useful when information 
about system errors (device errors, timeouts, cache and memory 
parity errors) is needed. However, file space is needed for 
the records and this option automatically includes support for 
checkpointing and the Send/Receive directives. 

• Size of dynamic storage region - It is possible to exhaust 
dynamic memory during the running of RSX-llM. This can occur 
if a large number of tasks are installed, if many volumes are 
mounted, or if a number of other conditions are present. This 
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problem can manifest itself in the lack of any response from 
the system. Although the system looks like it is operating 
successfully, it cannot accept any MCR commands or complete 
the execution of presently running tasks because they all 
require dynamic memory. Another manifestation of the problem 
may be I/O errors being received by tasks or failures in the 
Loader due to pool allocation failures. The only solution to 
this problem is to bootstrap the system and make more dynamic 
space available (SET /POOL) , remove tasks, mount fewer 
volumes, rebuild FCP with space for more file control blocks 
in its partition, or rebuild the system with more dynamic 
memory. See the RSX-llM System Generation Manual for a 
complete and detailed discussion of dynamic memory - its uses 
and its users. 

VMR installable Loader task - The Loader task occupies 2200(8) 
bjtes and is one of the Executive tasks. Installing and 
fixing the Loader in its own partition releases the 2200(8) 
bytes for use in the Dynamic Storage Region. 



F.4 FILE SYSTEM OPTIONS 

Many options of the INI and MOU commands can change performance. The 
more important options are: 

/EXT default extension block count - Unless this block count is 
specified, the file has a default block count of five, whether 
it uses all five blocks or not. If the default is used and the 
file is larger than five blocks, the file is not continuous and 
more accesses are required for the file. If the file uses less 
than five blocks, all five blocks are reserved for the file and 
no other file can use them. On the other hand, if you specify 
one as the block count, the file gets only the number of blocks 
it needs but it may require many accesses to access the whole 
file. To conserve space and reduce the number of file 
accesses, be as specific as possible about the number of blocks 
that your files need. 

/INDX index file position - The position of the index file in large 
volumes is important because of seek time. Rather than have 
the index file at the beginning or end of a volume, position 
it, either by block number or the MID key word, at the 
mid-point of the volume. In the case of small volumes, such as 
a floppy-disk, putting the index file at the mid-point will 
limit the maximum size of the work files on the disk. In this 
case, put the index file at the beginning or end of the volume. 

/LRU memory buffers to speed up directory searches - LRU specifies 
the number of 512-byte buffers to be maintained in memory. The 
buffers contain only the most recently accessed directories. 
The default is three buffers. If your application is working 
with a small number of directories, the defaults may be 
sufficient. However, if many directories are being scanned 
frequently, access time will improve if you specify a higher 
number than three. However, more buffers use more memory. 

/WIN mapping pointer count - WIN specifies the number of mapping 
pointers to be allocated for file windows. The default is 
seven pointers. The pointers point to contiguous blocks of the 
file on the disk. Access to fragmented files may be optimized 
by increasing the number of pointers. However, additional 
memory may be freed by reducing the number of pointers for 
files with little or no fragmentation. 
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F.5 HELPFUL HINTS 

• Avoid entering CTRL/C to explicitly request MCR. Typing 
CNTRL/C slows down response to other users needing MCR 
facilities. 

• Use indirect command files to MAC and TKB whenever possible, 
especially if the commands are long. If you do this, MAC or 
TKB spend less time competing for resources. 

• When task building or assembling large programs, insert all 
modules in a created library and specify each module by name. 
This reduces the number of times that TKB or MAC have to open 
files. 

• If you are doing SYSGEN with a mapped baseline system and your 
system has enough memory, create a separate 32K partition and 
install PIP, BIGTKB, and BIGMAC in this partition; this 
shortens the time taken for SYSGEN. 

• If you have the room, install BIGTKB and BIGMAC with a large 
/INC. This reduces the system overhead that TKB and MAC would 
cause when they executed Extend Task directives. 

• Install PIP with an increment (/INC). In general, run 
utilities in the largest possible partition. 

• If your system uses RMS, build the library modules as 
memory- resident. 

• Use the following form, shown as an example, to call utilities 
whenever you want to use a utility once: 

>PIP command <CR> 

Using this form reduces the time that PIP (or any other 
utility) spends competing for the memory resource. However, 
if you intend to u£je a utility to perform multiple operations, 
use: 

>PIP 

PIP> command <CR> 

PIP> command <CR> 

PIP> command <CR> 

CTRL/Z 

> 

• Use the print spooler as much as possible. This avoids 
leaving utilities in memory while printing on the line 
printer. 

• To save memory space by reducing task size, you may want to 
build a resident (sharable) library containing frequently-used 
FORTRAN routines. For the same reason, you may want to 
produce a position-independent library containing all the FCS 
modules required by a set of programs that are intended to run 
simultaneously. FCSRES.MAC and FORRES. MAC files are provided 
on the distribution disk. Building a FORTRAN and FCS resident 
library is described in the RSX-llM System Generation Manual . 

• Plan the overlay structure of your tasks. You may possibly 
achieve a large reduction in disk accesses by careful 
planning. 
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Avoid putting all the files needed by an application in a 
single UIC. Having all files in a single UIC slows down 
directory searches as each block can hold 32 entries only (8 
words per entry) . Many more disk accesses are required to 
search for the 300th file in a single UIC than the 30th file 
in the last of 10 UlCs. 

RMDEMO does add some overhead to the system's operation. It, 
is not necessary to run RMDEMO continously, only when the 
information that it supplies is required. However, if you do 
not run RMDEMO continuously, you may not be able to observe 
the system when a problem occurs (for example, dangerously low 
and decreasing pool space) . 



F.6 SOME DSEFDL COMMANDS 

There are four commands that can give you a description of your system 
that may be useful when you tune your system. They are the Tasklist, 
the Partition Definitions, the Task List, and the Active Task List 
commands. These commands are more fully described in the RSX-llM 
Operator's Procedures Manual . 

TASK LIST - Short Version 

The Tasklist command displays on the entering terminal a brief 
description of each installed task. The display contains, from left 
to right: 

1. Task name 

2. Task version identification 

3. Partition name 

4. Task priority 

5. Size of task in bytes (8) 

6. Load device identification 

7. Disk address logical block number (8) 

8. Task memory state 
Format: 

TAS 

Example: 

...LDR 07.05 LDRPAR 248. 00002200 LB0 :-01035303 FIXED 

TKTN 03.3 SYSPAR 248. 00010000 LB0 :-01126742 

RMDEMO X03.03 GEN 225. 00013700 SY0 : -00352100 

MTAACP 0006 GEN 200. 00013000 DS0 :-00000777 

F11MSG V0010 GEN 200. 00005400 SY0 :-01053030 

...MCR 01 GEN 160. 00025000 LB0 : -01051676 



ETC, 
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PARTITION DEFINITIONS 

The Partition Definitions command displays on the entering terminal a 
description of each memory partition in the system. 

The display consists of five columns that specify (in order from left 
to right) : 

1. Partition name 

2 Partition base address (8) 

3. Partition size (8) 

4. Partition kind: main partition (MAIN) or subpartition (SUB) 

5. Partition type 

TASK for user-controlled 

COM for common 

DEV for device registers 

SYS for system-controlled 

Taskname for task region 

D ...MIC for dynamically created region 

DRIVER for region occupied by a loadable driver 

Format: 
PAR 

Example: 



Name 


Base 


Size 


Type 






LDR 


000000 


000000 


MAIN 


TASK 




SYSPAR 


120000 


010000 


MAIN 


TASK 




FCPPAR 


130000 


026000 


MAIN 


TASK 




PMDPAR 


156000 


020000 


MAIN 


TASK 




SPLPAR 


156000 


010000 


SUB 


TASK 




DRVPAR 


176000 


014000 


MAIN 


SYS 






176000 


001600 


SUB 


DRIVER - 


DB 




177600 


000500 


SUB 


DRIVER - 


DS 




200300 


001000 


SUB 


DRIVER - 


DK 




201300 


001100 


SUB 


DRIVER - 


DT 




202400 


001000 


SUB 


DRIVER - 


LP 




203400 


003100 


SUB 


DRIVER - 


MM 


GEN 


212000 


546000 


MAIN 


SYS 






212000 


013400 


SUB 


(RMDEMO) 






225400 


045700 


SUB 


(.. .EDI) 





ETC, 



TASK LIST - Long Version 

The Task List command displays on the entering terminal the names, 
descriptions, and status of all installed tasks or of a .specific 
installed task in the system. 
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The display contains, reading from left to right, the following 
information for each task: 

• Task name 

• Task control block physical address (8) 

• Partition name 

• Partition control block physical address (8) 

• Partition base and limit physical address (8) 

• Task's running priority and default priority 

• Task status flags 

• TI terminal physical device unit 

• I/O count (10) 

• Task local event flags 

• Task registers and processor status word (memory-resident 
tasks only) 



Format: 

TAL [taskname] 

Example: 

. LDR. 052220 LDR 052164 00000000-00000000 PRI - 248. DPRI - 248, 

STATUS: -CHK FXD STP PRV 

TI - COO: IOC - 0. EFLG - 000001 000000 PS - 170000 PC - 041350 

REGS 0-6 000162 004030 177777 105312 064254 105260 052132 
TKTN 105010 SYSPAR 107734 00110000-00120000 PIR - 248. DPRI - 248, 

STATUS: -EXE OUT -CHK -PMD PRV 

TI - COO: IOC - 0. EFLG - 000001 000000 



ETC. 



ACTIVE TASK LIST 

This command displays on the entering terminal the names, 
descriptions, and status of all active tasks in the system or the 
status of a specified active task (taskname) . The display is the same 
as the Task List command. 

Format: 

ATL [taskname] 
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F.7 A DSEFDL TOOL 

RMDEMO is a privileged task that displays in a highly visual and 
active manner information concerning task activity in an RSX-llM 
system. The display usually runs continuously on a video terminal 
with cursor control (the VT05B or the VT52) . Certain versions of the 
task allow a once-only display on any record-oriented device. 

The display features include: 

1. Current date and time; 

2. The currently active task; 

3. All tasks, loaded drivers, and common blocks that are 
currently in memory, displayed in a graphic fashion to show 
their individual memory requirements and location relative to 
other tasks; 

4. The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by each group; 

5. The current amount of available system dynamic memory (POOL 
space) , including the largest available block and the number 
of fragments; 

6. A graphical display of the partition information; 

7. The number of hours that have elapsed since RMDEMO was 
initiated (this is system up time if the STARTUP_CMD file 
automatically runs RMDEMO when your system comes up) . 

8. The number of free blocks available on the system device and 
one or more additional mounted FILES-11 volumes; 

9. The system error sequence count. 

RMDEMO scales the display to the memory size of the computer on which 
it is executing. The amount of memory displayed on the screen is 
always the next largest power of 2 in K-words. For a 28K system, it 
displays 32K. For a 256K system, 256K is displayed and the available 
memory just fills the screen. 

You should consider task locations and sizes that RMDEMO displays to 
be approximate only. RMDEMO provides a visual display and is a system 
debugging tool; however, it should not be used for accurate 
measurement of task size and location. 

A complete description of RMDEMO can be found in the RSX-llM System 
Generation Manual. 
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Logical address space 1-14, 1-15 
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Partition status word bit 

definitions 8-42 
Partition types 1-3 
Partition wait queue, example of 
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first pass of 2-14 

second pass of 2-14 
Shuffling, for tuning F-2 
Size of dynamic storage region, 

for tuning F-2 
Slave terminals 1-27 
Snap block 8-46 

Snap control block macro C-124 
SNAP$ macro C-12 4 
Snapshot sump macro C-124 
SNPBK$ macro C-124 
SNPDF$ macro C-125 
SOB macro C-75 
Source files B-ll 
SPCIO$ macro C-121 
Speed types, for set character- 
istics C-130 
SPND$ macro C-61 
SPND$S macro C-60 
SPND$C macro C-60 
Spooler, print 1-7 
SPRA$ macro C-62 
SPRA$S macro C-61 
SPRA$C macro C-61 
SRRA$S macro C-109 
SRRA$C macro C-10 9 
SRDA$ macro C-63 
SRDA$S macro C-6 3 
SRDA$C macro C-62 



SREF$ macro C-10 7 8 

SREF$S macro C-108 

SREF$C macro C-108 

SRRA$ macro C-109 

SSTSR module description 7-77 

Stack structure, fault tracing 

E-8 
Stack, system 1-16 

system, queuing interrupts on 
3-12 

upon entry into directive 
processing 3-10 
Standard codes, driver C-117 

executive C-117 
Standard symbols, using the B-3 
Standards and conventions , 

coding B-l 
State generation macros C-125 
STATES macro C-12 6 
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System pointers 8-1 
System stack 1-4, 1-16 
System stack, queuing interrupts 

on 3-12 
System state, exiting 3-15 
System task directory 1-10 
System task directory list 8-11 
System traps 1-18 
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